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The Archimedes Magazine 
and Support Group. 


EDITORAL 


As the launch of RISC OS draws nearer, so more information becomes available on exactly 
what users will get in their upgrade kit. One of this month's articles makes an attempt to pin 
down the major software enhancements in RISC OS, and to give a shortlist of the 
applications software which will accompany the ROMs - though shortage of space on the new 
Welcome discs may mean that some items, such as the additional fonts, may not after all be 
included 


As far as documentation is concerned, Acorn plan to include two manuals with the upgrade: a 
new Welcome Guide, and a RISC OS User Guide, This latter will detail the Archimedes' major 
star commands, including of course those new with RISC OS, and will provide an Introduction 
to multi-tasking and the Desktop. Neither manual will cover the Basic language, which 
remains virtually unaltered. Such new features as have been introduced will be covered in 
subsequent editions of the Basic User Guide for the machine. 


Acorn are also working on a new version of the Programmer's Reference Manual, which will 
probably run to three volumes, and will not be available for some months. Neither this nor the 
Basic User Guide will be offered as an upgrade, though the whole of the present Basic User 
Guide is totally applicable to RISC OS, and virtually everything in the present Programmer's 
Manual similarly applies. 


This underlines the nature of the RISC OS upgrade, which provides features in addition to 
those currently available under Arthur 1.2, In fact, even though RISC OS may be installed in 
your machine, you can virtually ignore it, and use the machine as if it still contained the old 
1.2 OS, with almost all software running as it did before. Once you make use of the new 
features however, you have something akin to a completely new machine, with a set of 
extremely powerful and impressive features. 


The only downside to the new operating system is that it has become significantly more 
complex from a programming point of view, and this particularly applies to the whole WIMP 
system, which is now central to (he machine's operation in any multi-tasking application. But 
this is where RISC User comes in. In the coming months we will try to throw some light on the 
more important features of RISC OS, though without of course compromising our coverage 
of other aspects of this first class machine. 


This month’s tetesoftwarepasswords strawberry, 
(see BEEBUG pages on Micronet) 












NEW COMPUTER? 

Acorn was quick to react to the story about the new 
Archimedes 205 that was carried in last month’s RISC 
User. Acorn confirmed that there will be a new machine, 
although it will not be a cut-down version of the 310. 
Indeed, one source has said that the new machine, 
codenamed the "XXXX", will not be marketed under the 
Archimedes name. Acorn neither confirmed nor denied 
the price of £599 that we suggested, although they did 
confirm that the machine would be launched in the 
summer. 

It is also believed that Acorn is planning some 
changes to the existing Archimedes series. These will 
most probably be announced to coincide with the RISC 
OS release in April or May. 

ANIMATE YOUR IMAGES 

Film-Maker from Silicon Vision is an animation 
system for use with the company’s SolidCAD and Real¬ 
time Solids Modeller systems. It allows individual frames 
to be linked into an animated sequence, and various 
effects applied to the images. For example, the camera 
angle can be altered to produce a variety of effects. Film- 
Maker costs £79.95 inc. VAT. Further details can be 
obtained from Silicon Vision, Signal House, Lyon Road, 
Harrow HA1 2AG, tel. 01-861 2173. 

Not to be deterred, Ace Computing who produce 
Euclid, a rival to Silicon Vision’s SolidCAD, has released 
its own animator, called Mogul. This offers similar features 
to Film-Maker, and costs £20 inc. VAT to registered Euclid 
users. Further details from Ace Computing, 27 Victoria 
Road, Cambridge CB4 3BW, tel. (0223) 322559. 

ARC FAX 

Computer Concepts has said that its Archimedes Fax 
podule will be available in the near future. The system has 
now passed the main hurdles involved in obtaining BABT 
approval, and it only remains for the approval to be 
officially registered. Computer Concepts has also finally 
announced the price for the Fax system. The actual Fax 
podule, which is little more than a fast modem with error 
correction and all the necessary software, will cost 


£573.85 inc. VAT. However, this will only enable you to 
send on-screen images. To enable written documents to 
be sent, you will also need a scanner, and this pushes the 
price up to £918.85. More details can be obtained from 
Computer Concepts, Gaddesden Place, Hemel 
Hempstead, Herts HP2 6EX, tel. (0442) 63933. 

ETHERNET FOR THE ARCHIMEDES 

Acorn has announced an Ethernet interface podule 
for the Archimedes. This will allow machines to be 
networked using the very high speed local area network 
developed by Rank Xerox. It will also mean that 
companies and establishments that already have an 
Ethernet system can use the Archimedes as a low-cost 
intelligent terminal. 

The Ethernet podule will come in two forms, one for 
standard Ethernet systems, and the other for the lower- 
cost thin cable Ethernet. The actual hardware is the same 
as used in the new Acorn Unix machine, but because of 
software development time, the Archimedes Ethernet 
interface will not be available until September, and no 
price has been announced yet. 

MORE ART 

Atelier, from Minerva, is the latest Archimedes art 
package to be released. The program works in 256 
colours, and offers all the features that people have come 
to expect of Archimedes art packages, including the ability 
to distort an image into a particular shape. Also included is 
an independent sprite designer that can be used to define 
sprites for use in your own programs. Atelier costs £99.95 
inc. VAT, and more details can be obtained from Minerva 
Software, 69 Sidwell Street, Exeter, EX4 6PH, tel. (0392) 
437756. 

CONGRATULATIONS 

At a recent meeting of Acorn's Premier Dealer 
League, consisting of the top 25 Acorn dealers, BEEBUG 
was one of three companies which were presented with 
awards for their support of the Archimedes range. The 
other awards went to Watford Electronics and Twyford 
based MAV Ltd. gjj 
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UUhat'5 new in RISC OS 


A checklist compiled by Lee Catcram 


THE DESKTOP 

The Archimedes Desktop has been vastly 
improved* and supports multi-tasking through 
the WIMP. New tasks are started by double¬ 
clicking on an application directory from within 
the Desktop. The Desktop now works in all 
modes, automatically scaling sprites and text 
characters where appropriate. 

Ultimate control over multi-tasking is 
provided by the Task Manager, which may be 
called from the Desktop to alter configuration 
settings, and to set the RAM available for the 
next task. 

The revamped Desktop is now a real 
module, and does not overwrite user 
workspace. It is much more powerful, and you 
may perform many more operations directly 
from it. These include: delete, rename, copy or 
change access of a file or directory, format or 
backup a disc; and most important of all, run a 
file or application. Copying is performed by 
dragging a file to the new directory. 

To run an application, just double-click on 
the application directory, or on an associated 
data file. Alternatively, you can drag a file onto 
the application's icon, and this will start the 
application, and toad the file into it. If you need 
to open an application directory, you must 
double click on it while pressing the Shift key. 

The WIMP, A number of new WIMP calls 
have been introduced to cater for multi-tasking. 
The WIMP now allows window dragging with 
continual refresh of the dragged window. To 
implement this, use ‘Configure WimpFlags 
15 (0 resets it). 

BASIC 

The new version of Sasic supplied with 
RISC OS has a number of enhancements. 
These are mainly concerned with array 
operations and the assembler There is also a 
number of additional routines exported by the 
CALL statement. 


FILING SYSTEM 

ScreenSave/Load, ‘ScreenSave and 
‘ScreenLoad have been considerably speeded 
up when used with a full-sized graphics 
window. 

Obey Files . A new file of type &FEB has 
been introduced. This is similar to an Exec file 
except that the contents of the file are sent 
directly to the operating system. Obey files are 
not closed when an application is started, and 
will continue to be obeyed once the application 
ends. The contents of Obey files are not 
normally echoed to the screen. 

Copy T . A new ‘COPY option, using the 
parameter *T\ will cause a directory structure, 
but not its component files, to be copied. 

RAM Filing System. A complete RAM filing 
system has been implemented allowing fast 
saving and loading to an area of designated 
RAM (use ‘Configure RamFsSize). 

HourGtass . A dynamic hourglass pointer 
can be made to appear during filing and other 
operations to indicate the time during which the 
processor is busy. The hourglass appears 
auto m ati ca I ly du ri ng n et wo rk fili ng ope rat i o ns. 

DISC 

The E Format . A new 8Q0K disc format is 
provided which fragments files, and so does not 
need repeated compacting (though ‘Compact 
can still be used to de-fragment files). The new 
format also holds a back-up copy of the space 
allocation map, so reducing the likelihood of 
disc errors. The new command ‘CheckDisc 
checks this data. 

Disc Names, On RISC OS discs are 
referred to by disc name {drive numbers are 
generally not used). So all discs should be 
given a meaningful name using ‘NameDtsc. 

SPRITES 

Sprite Extend Module . This new module 
adds many sprite SWI calls. Sprites may be 
scaled {magnified or reduced), and their palette 
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controlled. VDU commands can be directed to 
sprites, so that a sprite may be written to even 
when not on screen, and sprites may be easily 
converted for use as pointers. 

VARIOUS 

New Modes. Screen modes greater than 20 
have been altered and vastly extended. Mode 
21 now gives 640x512 resolution in 256 colours 
(using 320K, and needing a multi-sync). Mode 
24 gives 1056x256 resolution in 256 colours, 
and will work with an ordinary monitor. Modes 
25-28 cater for IBM compatible VGA monitors. 

International Keyboard . This new module 
allows the keyboard to be reconfigured to 
accommodate the currently selected country. 
An unwanted side-effect is that the Ait key can 
no longer be used like Shift or Ctrl* To regain 
th i s f aci lity, u se * U n P lug I nte m ati o nal Keyboard * 

*Heip. This has been extended so that 
*Help ^module name> will list the star 
commands and configuration options provided 
by that module, 

BUNDLED APPLICATIONS 

A collection of disc-based applications is 
supplied with RISC OS. The majority of these 
will multi-task from the Desktop. 

MAJOR APPLICATIONS 

ArcEdit. This is a full-feature text editor, 
which can use normal or fancy fonts. It has cut 
and paste facilities, and can operate on 
multiple windows. It is ideal for creating Exec 
and Obey files, but is equally at home with 
ordinary text, or with binary files. 

ArcDraw. This is a powerful object- 
orientated drawing package with many of the 
features of CAD software. It can handle 
splines, and objects may be rescaled and 
rotated. Text in fancy fonts can be placed 
anywhere within the active window, and text 
from ArcEdit can be imported. 

ArcPalnt By contrast this is a pixel- 
orientated painting program, and replaces that 
supplied on the original Welcome disc. Again it 
multi-tasks through the WIMP, and any number 


of windows may be opened, ft is ideal for 
producing and editing sprites for use as icons 
etc. 

MINOR APPLICATIONS 

Maestro. This is a new version of the music 
editor supplied on the original Welcome disc, 
though it is much less colourful, because it 
must conform to the multitasking palette. 

Configure . This is a simple WIMP-based 
set-up screen for the main configure options 
such as beep volume, keyboard auto-repeat, 
and so on. 

Magnifier . This shows off the use of the 
scaling routines in the sprite extend module, 
and displays a mouse-driven magnifying glass, 
which will magnify any area of the screen. 

Puzzle and Patience. Two multi-tasking 
games to think about while you format discs. 
Unfortunately none of the Arc's filing operations 
are multi-tasked, so everything stops for loads, 
saves, formats and the like. 

TInyDirs- This useful application allows 
icons of frequently used applications to be 
posted on the icon bar for instant access. 

The inevitable Clock, Alarm and Calculator 
are also included, as is a small application 
giving a graphical representation of CPU 
usage, an electronic mail handier, and the 
Lander program from the Arthur Welcome 
disc - though the latter will unfortunately not 
multi-task. 

ADDITIONAL ITEMS 

Basic Edit This is now supplied on disc, 
due to tack of room in the RISC OS ROM. The 
same is true of the HardCopy module. 

6$Host and 65Tube. New and improved 
versions of the 65G2 emulator to emulate the 
model B or a 6502 second processor. 

Fonts. Three fonts are supplied on disc: 

Corpus Medium 

Porterhouse Standard and 

Trinity Medium rn] 
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A SIMPLE SPRITE MANAGER 


Manage your store of resident system sprites with this short piece of code 

by Mike Ironmonger. 


Keeping track of system sprites, and 
selectively deleting those no longer required is 
a tiresome task, since "SDelete requires the 
exact name of any sprite to be deleted. The 
utility listed here provides a single star 
command: 

*SWipe 

which displays each sprite in turn, and asks 
whether it should be deleted* 

The program is extremely short, and is 
given the file type &FFC. This means that it is a 
so-called Transient Utility, and does not need to 
be specifically loaded before use. All you need 
to do is issue the command *SWipe, and the 
code will be loaded from disc into the RMA 
area (though it is not a Module as such). It will 
then execute, and will be automatically cleared 
after use. 

To make use of the program, type it in 
carefully* save away the source code, and run 
rt - making sure that your disc has a directory 
named $.Library, The Transient Utility will be 
assembled and saved to $.Library ready for 
use. 



10 REM >SpriteMan 

20 REM Program Sprite Manager 

30 REM Version A 1,30 

40 REM Author Mike Ironmonger 

50 REM RISC User March 1989 

60 REM Program Subject to Copyright 

70 

80 MODE0:DIM.code% 500 
90 FORA%=0T01:P%=code% 

100 ; 

110 [OPT A%*2 


120 MOV R0,#8;SWI "XOS^SpriteOp" 
130 MOWS PC,R14;M0VS R8,R3 
140 BNE first_sprite 
150 : 

160 SWI "XOSWriteS" 

170 E0U5 "NO Sprites defined"+CHR$13+ 
CHR$1G+CHR$0 

180 MOV FC,R14 
190 : 

200 ♦firstsprite 

210 MOV RQ,#135:SWI "XOS^Byte" 

220 MOV R9 # R2:MOV R7,#l 
230 : 

240 ♦next_sprite 
250 MOV ~RG f #13:MQV R2,R12 

260 MOV R3,#13 : MOV R4, R7 

270 SWI "XOSSpriteOp" 

280 : 

290 MOV RQ,f 4 0:SWI "XOS SpriteOp" 

300 TEQ R6,R9:5WIEQ £20100+12 
310 SWINE £20100+22:M0VNE R0,R6 
320 SWINE "XOSWriteC" 

330 MOVNE R9,R6 
340 : 

350 SWI "XOS_WriteS" 

360 EQUS "Delete ’"+CHRSQ 

370 MOV R0,R12:SWI "XOSWriteO" 

380 SWI "XOSJfriteS” 

390 EQUS 1,1 (Y/N) ? "+CHR$0 

400 : 

410 MOV RQ,#34:MQV R3,#0 

420 MOV R4 f R4,L5L #2 

430 RSB R4,R4,#992;MOV R5,#8 

440 SWI "XOS_Spr11eOp" 

450 r 

460 SWI "XOSJteadC":BCS end 

470 TEQ R0, #ASC"Y n : TEQNE R0,#ASC"y" 
480 ADDNE R7,R7,#1:MQVEQ R0,#25 
490 SWIEQ "XOSSpriteOp" 

500 : 

510 SUBS R8,R8,#1:BNE next_sprite 
520 *end 

530 MOV R0,#126:SWI "XOSByte" 

540 SWI £20100+12:MOV PC,R14 

550 ):NEXT 
560 : 

570 SYS "OS_Flle",10,.Library,SWipe" 

,£FFC,,code%,P% 

580 PRINT " r * SWipe 1 command now instal 
led in library" __ 
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ce Computing 


Euclid 

The 3-D modelling 
and animation system for 
the Acorn Archimedes. 


Latest version includes NEW lighting effects and help 
menu, plus easier ways of colouring and viewing scenes. 

Here's what the reviewers say: 

“...even half an hour spent with Euclid will suggest 
many uses in education, professional design, math¬ 
ematics, programming, and CAD applications: buy 
it...and you won't be disappointed. 9 * 

Micronet 

“Children enjoy the immediacy of this program and its 
ability to capture the imagination of even reluctant 
learners is quite extraordinary. 99 
The Times Educational Supplement 11 November 1988 

EUCLID - Explore a new dimension! 

Price: £45 (inc VAT and P&P). 

Coming Soon: Orders now being taken for new 
RISCOS only ver$ion-£70. 

Available by mail order from: ^ 

Ace Computing, 27 Victoria Road, Cambridge CB4 3BW. ™ 
Or from your local dealer. BujinduiOQ 901 
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Use this short program by Nathan Williams to wrap flat Images around a sphere, 
and spin them anywhere on the screen. 


You will need at least 50K of sprite space to run 
this program. 


You may have seen Are screen displays of 
rotating worlds similar to the BBC1 world logo. 
The technique used to generate these is to 
produce a single flat world map (Le. a Mercator 
projection), and then wrap it around a sphere. 
To give the impression of rotation, a series of 
wrapped images are created from the original 
flat map, each differing from the next by a few 
degrees. When the sequence is played back a 
very powerful impression of rotation Is created. 



Image wrapping In progress 


The accompanying program uses similar 
techniques, but since it is written in Basic, and 
has been made modular, ft is easy to adjust to 
provide different effects. If you type it in and run 
it as it stands, you will see a rectangular image 
containing the words "RISC USER" at the 
bottom left hand corner of the screen. This 
serves as the image to be wrapped. The 
wrapping process begins immediately, and you 
will see a spherical transform of the flat map 
slowly build up in the upper right-hand quadrant 
of the screen. 

As scon as the image is complete, it will be 
stored in the machine's sprite area as a sprite 


named Spheral , and a new spherical image, 
similar to the first, but offset by a small 
rotational angle, will be generated. This will be 
stored as the sprite SphereZ The process wifi 
continue until the sphere has been mapped 
from all angles, and the display will then begin. 
This simultaneously rotates three spheres, each 
carrying the RISC USER title. 

It is possible to save the sprites used by the 
program. To do this, press Escape during the 
display phase, and use: 

*S$AVE mysprites 

To make use of the sprites at any time, use: 

*SLOAD mysprites 

Then, with the program in memory, type: 

PROCplay 

As I mentioned earlier, the program is easily 
customisable. You can change the original 
image, the size of the sphere, the angle of 
rotation, and the lighting and reflective 
properties of the sphere. You can also alter the 
program so that it generates just a single 
wrapped image rather than a whole sequence. 

Firstly, the original image: this is generated 
by PROCscreen, which may be replaced by 
your own routine. The image used must be 
twice as wide as it is high, and its height must 
be equal to the value held in the variable map% 
{in PROCinit). This is currently set to 96 for an 
image 192x96 graphics units in size. 

The size of the resultant sphere is 
determined by the variable rad%, set up in 
PROCinit. This is currently set to 75. 
Remember that increasing this will radically 
affect the space needed to store the resultant 
sprites, and the time taken to generate them. 

To alter the rotation from vertical to 
horizontal, change the main FOR loop variable 
in line 120 from anglev to angleh. 

The angle of lighting of the sphere is 
determined by the x, y and z co-ordinates of the 


RISC User March 1989 


9 

















light source, held in the variables lx, ly and Iz 
(defined in PROCinit), which range in value 
from -1 to +1. To remove the shading effect, 
set the variable shaded to FALSE in line 260, 
and to remove the highlighting effect, set the 
variable highl to FALSE in line 270. 



A sequence of sprites created by the 
program 


(f the shading effect is to work fully, then the 
original flat image should only use colours of 
maximum brightness. That is to say for 
example, if there is a blue component in a 
given colour, it must be maximum blue. The 
reason for this is that shading is achieved by 
reducing the intensity of each component of a 
given colour, and if colour components are at 
half intensity at the start, the result of shading 
may be to alter the colour rather than the shade 
of a given pixel. If the colours of an image do 
not contain full intensity components, such as 
would be the case tor a digitised image, for 
example, it will be best to remove the shading 
option; though you should be aware that the 
current program does not pick up tint 
information when transferring each pixel to the 
sphere. 

There is already plenty to experiment with 
here, but there is even greater scope for 
altering PRGGplay. At present, this displays 
three spinning spheres. But you could after the 
plotting positions so that one or more spheres 


appears to bounce around the screen. 
Remember, though, that if you intend to have 
more than one moving sphere on screen, then 
you will need to use bank switching to achieve 
smooth animation, since you wilt not be able to 
use Exclusive OR plotting to erase previous 
images. 
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REM >Wrap 

REM Program Image Wrap 

REM Version A 0*3 

REM Author Nathan Williams 

REM RISC User March 1989 

REM Program Subject to Copyright 

ON ERROR MODE 13:PRINT REPORT$;" @ 
ERL:END 
MODEl3:OFF 
PROCscreen 
PROCinit 

FOR anglev^0 TO 2*PI STEP PI/15 

PROCsphere(rad%,anglev,angleh) 

PROCgetsphere(rad%J 

NEXT 

PROCplay 

END 

DEFPROCinit 
DIM COl%{20,3) 

ORIGIN 840,712 
FOR C%=0 TO 13 

READ COl%(C%,1),COl%{C%,2),col%{C% 
NEXT 

lx=-0 * 55: ly=0.5:1 .7: REM Light 

shaded=TRUE: REM Shading On 

highl=TRUE: REM Highlight On 

map%-96: REM Image Height 

rad%=75; REM Sphere Radius 

HP=PI/2:sprite%=l 
anglev=Q:angleh=0 
ENDPROC 

DEFPROCscreen 

GCOL 0,12:RECTANGLE FILL 0,0,384,1 

COLOUR 140 TINT 240:COLOUR 0 
FRINTTAB £1,28);"RISC" 

COLOUR 3 
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iMg'L 'JtfKJVP S<PI$l 


390 PRINTTAB (1/29); "USER" 

400 COLOUR 32 : PRINTTAB (0,21) ; ,r * *" 

410 PRINTTAB(0,30);" * *" 

420 MOVE 300,100 
430 FOR J%=1 TO 20 
440 GCOL Q,RND(63) 

450 DRAW 224+RND(128),32+RND(128) 

460 NEXT 
470 ENDPROC 
430 : 

4 90 DEFPROCsphere(R%,anglev,angleh) 

500 COLOUR 63:COLOUR 128 TINT 0 
510 PRINTTAB(0,1)"Sprite sprite! 

520 FOR Y%*=K% TO -R% STEP -4 
530 FOR X%=R% TO -R% STEP -4 
540 Z%=FNgetz(X%,Y%) 

550 IF Z%>0 THEN 

560 PRQCtransf om (X%,Y%,Z%,anglev, angl 
eh) 

570 PROCgcol(X, Y) 

530 PLOT 69,X!,Y% 

590 ENDIF 
600 NEXT 
610 NEXT 
620 ENDPROC 
630 

640 DEFPROC get sphere (R%) 

650 MOVE -R%,-R%:MGVE R%,R% 

660 OSCLI ("*SGET sphere"+STRS (sprite!)) 
670 sprite!=sprite!tl 
630 ENDPROC 
690 ; 

700 DEFFNgetz (X!, Y%) 

710 Z%=rad*T2-X% A 2-Y! A 2 

720 

730 : 

740 DEFPRQCtransforrrMX!, Y!,Z%, anglev,a 
ngleh) 

750 newz=SQR(Z%)*CO$(anglev)-Y%*SIN(an 
glev) 

760 newy=Y%*CQS(anglev)+SQR(Z!)*SIN(an 
glev) 

770 theta=X!/SQR{X!*2+newz A 2) 

780 X=rad!*A$N(theta) 

790 Y~rad!*ATN(newy /SQR(newz 2+X! A 2)) 

800 IF newz<0 THEN X=(PI*R%)~X 

810 X+=rad%*angleh 

820 ENDPROC 

330 : 

340 DEFPROCgcol (X, Y) 


850 eolour!=FNcol(X,Y) 

860 brightness=FNbright(X!,Y%,SQR(Z%)} 
870 highlight!^(brightness*13+RND(1)/I 
5) 

880 light%= (brlghtness*12+RND (1) ) 

890 IF shaded THEN colour^colour! AND 
col%(light!,l):tint!=col!(light!,2) ELS 
E tint%=0 

900 IF highl THEN colour%=colour% OR c 
ol%(highlight!,3) 

910 GCOL 0,colour! TINT tint! 

920 ENDPROC 
930 : 

940 DEFFNcol(X,Y) 

950 x%-X/rad%/HP*map!:y!=Y/R!/HP*map! 
960 x%=(x%+map%) MOD (map!*4):y%=(y!+m 
ap%) MOD (map%*2) 

970 =PGINT(x!-840,y!-712) 

980 : 

990 DEFFNbright (x!,y%,z!) 

1000 x=x!/rad%;y=y!/rad%:z=z%/rad% 

1010 =(x*lx+y*ly+z*lz)/2+.5 
1020 ; 

1030 DATA %0l010l01,63,0,%01010101 f 63,0 
1040 DATA %01010101,127,0,,%01010101,191 

i0 

1050 DATA %10101010, 63,0, %10101010,127, 

0 

1060 DATA %10101010,191,0,%10101010,255 

,0 

1070 DATA %11111111, 63,0, %11111111,127, 

0 

1080 DATA I1UU1U,191,0 
1090 DATA 111111111,255,0 
1100 DATA %11111111,255,%010101 
1110 DATA *11111111,255,%101010 
1120 ; 

1130 DEFPROCplay 

1140 MODE 13 

1150 ORIGIN 0,0 

1160 REPEAT 

1170 FOR J!=l TO 30 

1180 OSCLI("SCHOOSE sphere"+STR$(J!)) 

1190 P1£>T SED, 0,500 

1200 PLOT &ED,880,500 

1210 PLOT £ED, 4 40,50 

1220 WAIT:WAIT 

1230 NEXT 

1240 UNTIL FALSE 

1250 ENDPROC RJ 


n 
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ANNOUNCING A MAJOR NEW SOFTWARE RELEASE 


(Premier 

Circle Software are proud to announce a major new text processor for the Archimedes 
featuring a major advance In capability. Premier la the first program of it's kind to indude 
what we have called - 

DYNAMIC TEXT 

This new concept slows the Inclusion of Hems within any document, whose textual content 
is not fixed, but may change after the Item has been Inserted. Such DYNAMIC TEXT Hems 
may show today's date or time, the current value of VAT, or a name and address. The 
actual text displayed may be defined at the keyboard, or In a separate text file. In fact 
different text fHes may define these DYNAMIC TEXT hems differently, to produce 
statements and Invoices, financial reports, or personalised mall shots. 

This is no pipe dream. Premier’s powerful command language includes full maths functions, 
repeat loops and *lf * then 1 constructs, all of which may be Included In the definition of 
a DYNAMIC TEXT Hem, allowing fun spread-sheet type facilities anywhere on the page, 
not just in neat rows and columns. But Premier does not stop there. 

The ability to read and execute commands from text files allows any text processing to be 
carried out just by typing a ’star’ command. Further, the ability to define 'macro 1 commands, 
plus the ability to define the action of ANY key, allows complete ’applications' to be built, 
Including customised spreadsheets, and simple data bases. A command file defining a 
full featured word processor, and a matching ksy-str^>, Is Included with Premier. 

This word processor alone is a justifiable reason for the purchase of Premier. It offers four 
way scrolling windows, Is able to cut and paste text between any number of files, features 
forward and backward searches, search pattern matching, headers and footers employing 
DYNAMIC TEXT, and other features too numerous to list here. The command file defining 
all this may be edited, to tailor the features to your own requirements. 

Premier will be enhanced further to Include more features and applications. As a RISC 
USER reader you can receive all updates free during 1080 by ordering NOW at a special 
price of just 50 pounds, or see DYNAMIC TEXT In action and try our word processor on a 
demo disc avlalable for just 5 pounds, refundable on a full order. 

Send NOW for full details of Premier, 
a refundable demo disc for 5 pounds, 
or a fun version of Premier, complete 
with manual, key strips, and a no quibble 
guarantee, for just 50 pounds. 

You have nothing to loose! 


Cirde Software 

33, Restrop View, 

Purton, Swindon, 

Wilts. SN5 9DG 






NEW FONT STYLES 


This short relocatable module by Peter Arnold provides 72 new styles 
for the Arc's normal screen font. 


The Font Masher relocatable module is 
designed to bridge the gap between the 
Archimedes 1 normal screen font (BFONT and 
its ISO variants), and the anti-aliased fonts that 
are loaded from disc. The normal font is quick 
and simple, but there is only one style. The 
anti-aliased fonts take time to load, and limit the 
palette availabfe for other purposes in all but 
the 256 colour modes. Font Masher provides 
seventy-two varied fonts that are used in 
exactly the same way as BFONT, and which 
retain BFONT's great speed. 

To make use of the module, type in the 
program in listing 1, and save it to disc. When 
run, it will assemble a module, and 
automatically save it to disc under the name 
RMmash. To use the module Just type: 

*RMmash 

If there is insufficient room in the RMA, type: 
*Quit 
*RMmash 
*Basic 

Now you can change fonts with the new star 
command *Mash. St lakes a numeric parameter 
from 0 to 255, which defines the new font. 
‘Mash 0 sets the font to normal. The table 
shows how the parameter is determined. If you 
want bold text, use: 

*Mash 128 

If you want bold and underlined, use: 

*Mash 136 

i.e. just add the codes for the features that you 
require. 


Bit Number 

Font Style 

Decimal 

0 

Italics 

1 

1 

Backward Italics 

2 

2 

Feint 

4 

3 

Underlined 

a 

4 

Inverse 

16 

5 

Superscript 

32 

6 

Subscript 

64 

7 

Bold 

128 


Table 1. Typestyles and corresponding 
parameters 


There are three pairs of font styles that 
cannot be used together for obvious reasons. 
They are: 

Italics and Backward Italics 
Feint and Bold 
Superscript and Subscript. 

Having tried some of the new font styles, 
you will probably find a number which you want 
to use. To make reference to them easier, you 
can use the Arc f s *SET Alia$$ command to give 
them appropriate names. For example, if you 
issue the following strings: 

*SET AliasSBold Mash 126 
and 

*SET AliasSNormal Mash 0 

then every time that you type: 

*Bold 

the bold font will be engaged. The command: 

^Normal 

will reset the style to norma!. 


The program in listing 2 gives a short 
demonstration of some of the styles available. 


HORHflL 

RBC xyz 123 

BOLD 

m xyz 123 

FEIHT 

RBC xyz 123 

I1BIIC 

BBC xyz 123 

.UNDERLINED_ 

.BBC ,x.yz..JL23 


— 

OCK X'li 123 


A display of the output from Listing 2 


Listing 1 

10 REM >Masher 

20 REM Program New Font Styles 

30 REM Version A 0.02 
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NEW [FONT STYLES 


40 REM Author Peter Arnold 
50 REM RISC User March 1989 
60 REM Program Subject to copyright 
70 : 

80 DIM R% £1000 
90 FOR 1=4 TO 7 STEP 3 
100 P%=0:O%=R% 

110 [OPT I 

120 EQUD0;EQUD 0:EQUD0:EQUD0 

130 EQUD title 

140 EQUD help 

150 EQUD command 

160 .title 

170 EQUS "FontMasher" 

180 EQUB 0 
190 ALIGN 
200 .help 

210 EQUS "Font Masher "-^CHR$9+ ,, 1.00 <" + 
MID$ (TIMES, 5,11)+")" 

220 EQUB 0 
230 ALIGN 
240 .command 
250 EQU$"Mash" 

260 EQUB 0 
270 ALIGN 
280 EQUD start 
290 EQUD £00010001 
300 EQUD mashsyntax 
310 EQUD mashhelp 
320 EQUD 0 
330 .mashsyntax 

340 EQUS "Syntax: *Mash <0-255>" 

350 EQUB 0 
360 .mashhelp 

370 EQUS 1, *MASH with a number affects t 
he characters shown on the screen. The e 
ffects depend on the setting of the lowe 
r eight bits of the parameter. Use *MASH 
0 to reset the font." 

380 EQUB 0 
390 ALIGN 
400 : 

410 .start 

420 STMFD Rl3S,{R0-R12,R14} 

430 MOV R1,RQ:MQV R0,#£30000000 

440 SWI 33:BV5 end 

450 MOV R6,R2;MOV R0,#2Q 

460 SWI 6;CMP R6 f #G 

470 BNE carryon 

480 B end 


490 : 

500 .carryon 
510 MOV R3,#32 
520 .getshape 

530 ADR Rl,block:STRB R3,[Rl,#0] 
540 MOV RQ,#10:SWI 7 
550 .go 

560 AND R7,R6,#1:TEQ R7,#l 
570 BNE go2:MOV R8,#l 
580 MOV R9,#1:MQV RIO,#31 
590 *italicsl 

600 BL rotate:ADD R8,R8,#1 
610 CMP R8,#4:BLT italicsl 
620 MOV R9,Rl0:MOV R8,#6 
630 .italics2 

640 BL rotate:ADD R8,R8,#1 
650 CMP R8,#9 
660 BLT italics2 
670 *go2 

680 AND R7, R6, #2 : TEQ R7,#2 
690 BNE go3 

700 AND R12,R6,#1;CMF R12,#1 

710 BEQ go3:MOV R8,#l 

720 MOV R9,#31:MOV R10,#1 

730 .Bitalicsl 

740 BL rotate:ADD R8,R8,#1 

750 CMP R8,#4:BLT Bitalicsl 

760 MOV R9,R10:MOV R8,#6 

770 ,Bitalics2 

780 BL rotate:ADD R8,R8,#1 

790 CMP R8,#9:BLT Bitalics2 

800 *go3 

810 AND R7,R6,#4:TEQ R7,#4 

820 BNE go4 

830 MOV R8,#l 

840 .feint 

850 LDRB R7,[R1,R8] 

860 MOV R9,R7,ROR #1 
870 AND R7,R7,R9 
880 STRB R7, [Rl,R8] 

890 ADD R3,R8,#1:CMP R8,#9 
900 BLT feint 
910 ,go4 

920 AND R7,R6,#8:TEQ R7,#8 
930 BNE go5 
940 .underline 
950 LDRB R7,[Rl,#8] 

960 ORR R7,R7,#170 
970 STRB R7,[ Rl, # 8} 

980 , go5 
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990 AND R7,R6,#16:TEQ R7,#16 
1000 BNE go6:MOV R8,#l 
1010 ,inverse 
1020 LDRB R7,[R1 , R&] 

1030 MVN R7,R7 
1040 STRB R7,[R1,R&] 

1050 ADD RSjr R8/ #1: CMP R0,#9 
1060 BIT inverse 
1070 .go6 

1080 AND R7,R6,#32:TEQ R7,#32 
1090 BNE go7 

1100 MOV RS,#1:MOV R9,*l 
1110 .superscript 
1120 LDRB R10, [Rl,R8J 
1130 STRB RIO, [R1,R9] 

1140 ADD RB fRBf #2:ADD R9,R9,#1 

1150 CMP R&,#9 

1160 BLT superscript 

1170 MOV R8 f #5:MQV R9 r #0 

1180 .blankbottom 

1190 STRB R9,[R1,R8] 

1200 ADD R&,R8,#1:CMP R8,#9 
1210 BLT blankbottom 
1220 ,go7 

1230 AND R7/R6,#64:TEQ R7,#64 
1240 BNE goB 

1250 AND R12,R6,#32:CMP R12,|32 

1260 BEQ go8:MOV R8,#7 

1270 MOV R9,#8 

1280 ,subscript 

1290 LDRB R10,[R1,RB] 

1300 STRB R10,[R1,R9] 

1310 SUB R8,RS,#2;SUB R9,R9,#1 

1320 CMP R8,#1:BGE subscript 

1330 MOV R8,#l:MOV R9,#0 

1340 .blanktop 

1350 STRB R9,[R1,R81 

1360 ADD R8,R8,#1:CMP R8,#5 

1370 BLT blanktop 

1380 .goB 

1390 AND R7,R6,#128:TEQ R7,#128 

1400 BNE define 

1410 AND R12,R6,#4:CMP R12,#4 

1420 BEQ define:MOV R8,#l 

1430 /bold 

1440 LDRB R7,[R1,R8] 

1450 MOV R9,R7,ROR tl:ORR R7,R7,R9 
1460 STRB R7,[R1,R8]:ADD R8,R8,#1 
1470 CMP R8,#9:BLT bold 
1480 -define 


1490 MOV R8,#0:MOV R0,#23 
1500 ADR R1,block:SWI 0 
1510 .vdu23 
1520 LDRB RQ,[R1,R8] 

1530 SWI 0 

1540 ADD R8,R8,#1:CMP R8,#9 
1550 BNE vdu23 

1560 ADD R3,R3,#1:CMF R3,#126 
1570 BLS getshape 
1580 .end 

1590 LDMFD R13!,(R0-R12,R14J 
1600 MOV PC,R14 
1610 .rotate 
1620 LDRB R7,[R1,R8] 

1630 MOV R7,R7,ROR R9 
1640 STRB R7, [R1/R8] 

1650 MOV PC,R14 
1660 .block 

1670 EQUD 0:EQUD OiEQUB 0 
1680 1:NEXT 

1690 OSCLI"SAVE REfcnash "+STR$-R*+"+"+ST 
R$-P% 

1700 OSCLI"SETTYPE RMmash FFA" 


Listing 2 

10 REM >Mash2Demo 

20 REM Font Style Demonstration 
30 : 

40 *RMMASB 

50 ON ERROR REPORT;IF ERR=17 THEN OSC 
LI("MASH 0"):END ELSE PRINT" at line ";E 
RL:END 


60 

MODE 0 




70 

*MASH 0 




80 

PRINT 1 "NORMAL 

ABC 

xyz 

123" 

90 

*MA$B 128 




100 

PRINT r "BOLD 

ABC 

xyz 

123" 

110 

*MASH 4 




120 

PRINT 1 "FEINT 

ABC 

xyz 

123" 

130 

*MASfl 1 




140 

PRINT 1 "ITALIC 

ABC 

xyz 

123" 

150 

*MASH 8 




160 

PRINT'"UNDERLINED 

ABC 

xyz 

123" 

170 

*MA SB 19 




180 

PRINT 1 "INVERSE ITALIC 

ABC 

xyz 

123" 

190 

*MASH 32 




200 

PRINT■"SUPERSCRIPT 

ABC 

xyz 

123" 

210 

*MASH 0 



rm 
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ADVANCED STATISTICAL SYSTEM 

For Acorn Archimedes; BBC Models B, B+ and Master; 'Industry Standard" machines 
A powerful and practical tool for Research, Industry, Business, and Teaching 

Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing variables and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics, Paired and unpaired t tests. Otiisquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 
Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions, 
Regression DIAGNOSTICS ■ VlFs, influential points etc. Automatic warnings. 

ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 

One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms, Linear Calibration. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities, 

Price El 20-El 80 (machine and version dependent). Special RISC USER discount available. 
There's far too much to (describe here. Get full information now from: 

Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L641SD TeL 051 327 4248 


Archimedes Shareware Discs 


Shareware Disc N- 2 
(£4.50) 

DFS reader, backup and 
archiver. 9 Graphics demos. 
Connect four. Mastermind, 
Solitaire and StarTrek games. 
256 colour Sprite Editor* 
CMOS ram Editor,' Disc 
Editor, LQ printer font definer. 
Matrix Functions, Memory 
Mappings & Vector Listings 
BASIC fast Screenload. 


Also Available... 

WIMP Template 
Editor (£8) 

Design your own windows, 
icons, menus and sprites - 
completely freehand in a 
Wysiwyg format. Create 
WIMP templates which can 
easily be loaded from yourown 
program - no more need for 
endless data blocks! !!l 

Based on the original “Form 
Editor” program from Acorn 
Computers, modified and 
extended (with Acorn's 
permission!) 


Graphics Demo 1 
(£3.50) 

49 graphics demo programs 
plus Menu Master-a program 
to allow you to edit the demo 
order and add your own 
favourite demos. 

Shareware Disc N 9 1 
(£3.50) 

MenuMaster withsevenmore 
graphics demo programs plus 
Life, Mandelbrots, Structured 
Directory Lister, European 
Geography, 


Save £1.50 -Buy alt 3 
for just £10. 


Prices include UK p&p. European prices as UK. Outside Europe sent by surface but add £ 1 per order 

I , u., r — r?_------* rivin m t 1 „_- 


for airmai I. Pay by U K cheque or Eurocheque or credit our Girobank account 2341107. Sorry no credit cards, 

Norwich Computer Services, 18 Mile End Road, Norwich, NR47QY. (0603-507057) 
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MAKING THE MOST OF LOGISTIX 


Mike Williams offers some advice on the use of Logistix, 
the first and maybe one of the best spreadsheets for the Archimedes. 


f have been using Logistix regularly ever since I 
first reviewed it for RISC User {Volume 1 Issue 3}. 
Although I have had the opportunity to try other 
spreadsheets as they have appeared (Matrix-3, 
GammaSheet and PipeDream for example). I have 
so far found no rea! incentive to change. The 
purpose of this article is to look at some of the more 
frequently used aspects of Logistix, and to present 
the fruits of my experiences so far. 

Logistix offers four different applications In a 
single package: spreadsheet, database, 
presentational graphics and time management I 
have to say at the outset, that apart from entering a 
few worked examples, I have personally found no 
use as yet for the last I have used the database 
facilities, but I find that a separate database system 
better satisfies my needs. Thus this report will 
concentrate on the spreadsheet and graphics 
capabilities, which are probably the most important 
and most commonly used parts of the package 
anyway. 

it seems to me that there are three key features 
when using a spreadsheet program. How easy is it 
to create a spreadsheet in the first place? How easy 
is it to update the data in your spreadsheet once 
entered? And, finally, and this applies right from the 
start, how easy is it to change the structure of your 
spreadsheet? Logistix works well on all counts, and 
it is the convenience of its user interface which I feel 
is largely responsible tor this. 

KEYBOARD INPUT 

Logistix may seem rather tame compared with 
some of the WiMP-based applications around. No 
mouse to click away with here. All user input is via 
the keyboard. The cursor keys provide basic 
movement around the screen, but Page-Up, Page¬ 
Down, F9 and F10 to move a whole screenful at a 
time (up, down, left, right) are also very useful. My 
main application has grown as time has passed, 
and I have a number of sub-spreadsheets located in 
different areas of the available worksheet. 

I’ve also set up graphics displays for most of 
these sub-sheets as well, again using different 
pages. It helps here to plan ahead and be 
consistent {for example, always keep your graphics 
programs In the first free page to the right of any 
spreadsheet). Even when you do, you still 
sometimes find you have located a blank area of 
the sheet, and the use of the Home key to return to 


the top left-hand comer of the sheet is a convenient 
way of restoring normality. 

Data, i.e. numbers or text, is Just entered straight 
in, being placed by Logistix in the current cursor 
position. Although you can use Return to terminate 
data entry, it is usually more convenient to use a 
cursor key, which not only fixes that piece of data, 
but allows you to move on automatically to the next 
input position. However, if you edit a field (/E) you 
must terminate the edit process with Return. You 
also have to get used to the iBM-style back-arrow 
key for deletion, and not the more usual BBC Delete 
key (which seems to have the same effect as 
Escape here). 


HINT 

I find with my own application a not infrequent need to 
update a number by adding a further value to it. Perhaps 
because I'm lazy, I use the edit facility to replace I he 
original number in a cell by an expression which is I he 
original number plus (or minus) the new number. I then 
use the replicate command (/R) with the values option 
(V) to replace the expression in the cell by the value ol 
the expression. The key sequence is; 

/RV|<Return> 


Logistix Is generally quite good at deciding what 
category of input it is being presented with. Text, 
numbers and expressions can often just be typed In. 
But other classes of input, such as graphics 
commands, need to be specified as such (a 
preceding comma for a graphics command for 
example). When you are trying to find why some 
aspect of your sheet is not working, do check that 
every entry Is of the right type. 

Logistix helps, because as you move the cursor 
about the screen, a display line at its foot not only 
shows what is really in each cell (a formula for 
example, when otherwise alt you would see is the 
value which results from that formula), but Logistix 
also tells you into which category the cell contents 
fall. Enter the PIA command to specify a pie chart, 
and the command will look the same in the 
spreadsheet whether the three letters are entered 
as text or as a graphics command. The difference 
can be the difference between success and failure, 
so don't get too complacent about input. 

REPLICATION 

One of the most useful features of any 
spreadsheet has to be its ability to replicate (copy) 
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values or formulae across cells, rows, columns or 
complete blocks of cells, I have not found Logistix 
wanting 3n this respect, though I have found 
difficulty In always getting things to work as I would 
wish. 



Replicating a column 


A major convenience of Logistix is that you 
seldom if ever need to enter cell references from 
the keyboard. Moving the cursor around the screen 
picks these up automatically. Thus if you want to 
replicate the contents of one column to a 
neighbouring column, move to the top of the 
column to be replicated {Its cell reference appears 
automatically on the input line at the foot of the 
screen), and press; 

/RR:<foot> r <start>Return 
where <foot> means move the cursor to the foot of 
the column to be replicated, and <start> means 
move to the first position of the new column. 

Note that when replicating a column or a row 
you only have to specify the first cell of the new 
location. It is worth practising with the use of the 
replicate command as you are likely to use it more 
than most. 

Another useful feature of Logistix is that cell 
references can be specified as absolute (upper 
case letters) or relative (lower case letters). 
However, to make use of this feature you must also 
select the correct setting in Global Options (/G), 
otherwise, like me Initially, you will begin to feel that 
this feature is a figment of the documentation. 

For example, if at the foot of column A you have 
the entry +SUM{A1:A9) in cell A10 {the V 
specifying an expression), and you replicate the 
column A1:A10 into column B, the summation will 


remain quite unaltered (with the correct global 
option set). But use the expression +SUM(ai ;a9) 
and on replication into column B this is converted to 
+SUM(b1:b9). Relative cell references throughout 
are the norm. 

Another example of replication uses the values 
option, and converts a formula into its 
corresponding value, I find this quite useful to fix a 
value at a certain point in time to form an historical 
record from then on (see also Hint), 

FORMATS 

Although Logistix as might be expected provides 
a good variety of formats, l have found some 
frustrations. The format command (/F) allows you to 
specify the width of a column and the format in 
which numbers, the lifeblood of any spreadsheet, 
will appear. You can select one or more rows or 
columns, or a block of cells, and apply any selected 
format to just that group of cells. However, fewer 
options are available when dealing with a block of 
cells than are available with rows and columns. This 
is unfortunate. 



Selecting a format 


A format (e.g. number of decimal places) 
applied to a column affects every single cell on the 
spreadsheet In that column. Given the paged 
approach to the use of the spreadsheet, I find I want 
different formats for different parts of the same 
column. But formatting a block of cells, which is 
what you end up doing, does not, for example, 
permit the number of decimal places to be specified 
(or fixed), a nuisance when dealing with some 
figures. 


Eight different formats are available for financial 
data, including the facility for negative amounts to 
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demonstrating Logistix 1 regrettable inability to take 
advantage of the colour range and sophisticated 
graphics of the Archimedes, while any text captions 
on a standard colour monitor are well nigh 
unreadable. Do make sure that the Logistics disc is 
inserted before displaying any graphs so that any 
fonts can be correctly accessed. Logistix gets rather 
unhappy otherwise. Ail in alt. I feel that the graphics 
are a considerable disappointment. 


appear automatically but disconcertingly in red 
(other, perhaps kinder, formats are also available). 

GRAPHICS 

I have used the graphics options to display parts 
of my spreadsheet in either barchart or pie chart 
format. This does not prove too difficult if you follow 
the examples given in the manuals. However, I find 
that most of the displays are quite crude, 


Displaying a graph 


FINAL THOUGHTS 

Much of what l have covered has derived, as l 
said at the start, from my own frequent use of 
Logistix to maintain what I fee! is a reasonably 
comprehensive spreadsheet application. For much 
of what I need, Logistix is ideal. However, I certainly 
do not claim to know everything there is to know on 
Logistix, and indeed I would welcome any feedback 
or further information from members, who may be 
able to add to my own experiences with Logistix for 
the benefit of others. 

Note: Logistix is published by Acorn Computers, 
and costs £113,85 inc . VAT (available at 5% 
discount to RiSC user members when 
purchased from BEE BUG). nn 


The Beard Technology Precision Picture System 

PPQOCfi Theu “ pixel PPQ 1C 

rro'Z/UU “£isr™ rro'iu 

Mode 15 £19.50 Art on a shoestring Mode 12 £17.50 

You can use it as a pixel editor. You can use it as an art package. 
Because ALL the graphics facilities can be used from within the 

zoom option. 

So easy to use that you could use it in a primary school, 
yet powerful enough for the sophisticated user. 

From BEARD TECHNOLOGY 111 Evering Road LONDON N16 7SL 
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Dealing RISC 05 Application Direc|ofie5 


Lee Calcratt looks Into RISC OS Application Directories and the powerful new Obey fifes. 


In RISC OS the whole Desktop concept has 
been revamped, and one of the new features to 
emerge as a result is the Application Directory. 
This is simply a directory in which all resource 
files for a given application are held, including 
boot files, sprites, and the application itself. But 
an application directory is no ordinary directory, 
it is a runnable object. Running an application 
directory by double-clicking on its icon will 
normally start up the application, or in certain 
cases, install its icon on the icon bar. 
Fortunately it Is a relatively simple matter to set 
up applications directories. 

First of all you need to create a suitable 
directory. Any name will do providing that its 
first character is T. When you have done this, 
the directory display will register an "A" icon 
alongside the new name, indicating that it is of 
type "Application". The new directory will need 
to contain at least three files: 

A file named !Run 

A file usually named IRunlmage 

A sprite file named ISprites 

I will deal with the sprite file first. This 
should contain one or more icon sprites, and 
the name of one of these must be exactly the 
same as that used for the application directory. 
For example, if the directory name is IQUIZ, the 
corresponding sprite file (called ISprites) should 
contain a sprite called IQuiz (as with all file and 
sprite names, case is ignored}. This sprite is 
displayed by the Desktop together with the 
name of the application, whenever the parent 
directory of the application is opened. 

A second sprite may be included for use 
with the small Desktop icon display. Its name 
must be the same as that of the main sprite, but 
preceded by the letters n sp w (e.g. Splquiz}. 
Sprites for data files associated with the 
application may also be included in this file, but 
this is beyond the scope of the present article. 
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The easiest way to produce suitable sprites 
is to use ArcPaint. Icon sprites should normally 
be a maximum of 68x68 graphics units in size, 
and should conform to the standard Desktop 
palette. As a temporary measure, you could 
borrow one of those supplied on the RISC OS 
Applications discs. Just drag the appropriate 
sprite file into your new directory. If you need to 
change its name to match your new directory 
name, then proceed as follows: 

*$NEW 

* SLQAD !Sprite 

*SRENAME !Puzzle 'Quiz 

*SSAVE !Sprite 

In the above example we have changed the 
name of the sprite used for the application 
!PUZZLE to one suitable for a directory called 
IQUIZ. Now when you next look at the directory 
containing your application directory, the new 
user-defined {or user-borrowed) icon will 
appear. 

OBEY FILES 

Now for the IRun file. This will normally be a 
file of a new type called Obey (type &FEB). 
Obey files resemble Exec files in that they 
contain executable commands, and may be 
used to start up an application, just like IBoot 
files. But they have a number of advantages 
over Exec files. Firstly, the text which they 
contain is sent directly to the operating system, 
and does not rely on the current task sending 
keyboard input to the O.S. Obey files must 
therefore contain no Basic instructions, only 
commands acceptable to the operating system. 
Secondly the contents of Obey files are not 
echoed to the screen unless the command 
Echo is issued. And thirdly, Obey files remain in 
'obey a nee' when an application is running, and 
then take over once the application ends. This 
can be useful in different ways. For example, it 
could be used to make back-ups of data files 
after the user has terminated an application, 
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Dealing RI5C 05 Application Directories 


To test this property, use ArcEdit or another 
text editor to create a text file of type FEB 
containing the following: 

Quit 

Basic 

Echo Why must you leave so soon? 

If you "RUN this file, Basic will be started up, 
and you can then run any programs that you 
wish* and providing that you do not issue a 
"Close, or Close #0, the Obey file will remain 
active. At the point that you finally quit Basic, 
the Obey file will continue, and will display the 
message before closing. This wit! work just as 
well with a single Basic program, providing that 
it is "RUN. Thus: 

QUIT 

MyProg 

Desktop 

would run the Basic program MyProg, and as 
soon as the program ends (whether naturally, 
or by pressing Escape), the Desktop will be 
called. 

An application must be able to work 
properly even if it has been transferred to a 
new parent directory (as it might be if it had 
been transferred to a network or to a hard 
disc). And one important use for the Obey file 
IRun in any application directory is to record 
the full path for the given application. The Filer 
automatically sets the variable Obey$Dir as 
soon as an Obey file is run, and one of the first 
tasks of IRun should be to store this 
information in a suitable environment variable. 
For example: 

Set MyProgSDir <0bey$Dir> 

This holds the path in the variable MyProgSDir 
for subsequent use. One of the final acts in the 
i IRun Obey file is to "Run the file IRun Image. 
This will usually be the application itself, 

A IRun Obey file for an application might 
therefore contain the following lines: 

Set MyProg$Dir <Qbey$Dir> 

Run <MyFrog$Dir>.!Rimlmage %*G 

Note the way in which the last line uses the 
convention %*G. If the application is ever run by 


issuing the command: 

*<DlrectoryName> parameters> 
this will ensure that any parameters 
accompanying this instruction are passed to the 
application (i.e. passed to I Run Image). 

If you examine some of the IRun files on the 
RISC OS applications discs, you will see that 
many of them contain additional instructions for 
setting RunType aliases to ensure that running 
data files for the application cause the 
application to start up. Others use the new star 
commands "RMEnsure and "WimpSlot to 
check the presence of important modules, and 
to claim workspace for the application. We will 
take a closer look at these In a forthcoming 
issue, 

SBOOT 

We have not as yet covered the new role of 
the IBoot file. Any application directory may 
contain a IBoot file. Again this will typically be 
an Obey file. This file is automatically run when 
it is first seen by the Filer. That is to say when a 
directory is displayed containing the parent 
directory of the application. Contrast this with 
the IRun file, which is only run when an 
application is selected by the user 

If a IBoot file is present it must contain the 
instruction: 

*TconSprites !Sprites 

because if a IBoot file exists, the lSprite file will 
not be automatically loaded. One further point: 
the IBoot file will only be automatically 
executed providing the icon sprite pool does 
not contain a sprite whose name suggests that 
the application is already known to the Filer (i.e. 
the sprite called kapplication name>). 

The best way to get to grips with application 
directories is to experiment with some of your 
own, and the best source of examples are the 
directories supplied on the RISC OS 
Applications discs. In the mean time, a 
complete application is supplied on this month's 
disc for your perusal. g^j 
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ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 

if you have written any programs, completed or not, then we would like 

to hear from you. 

If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 

If you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 

Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our Informal programmers seminars. 

The most important point is that you will be earning top royalty rates of if 
you prefer we wilt purchase your program outright. 

Please write, in confidence, to Mr, D. Clare at: 

Clares Micro Supplies, 

98 Middlewich Road, 

Northwich, 

CHESHIRE CW9 7DA 

If you have a program either complete or in development then please 
enclose a copy for our evaluation. 

To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 

Act today and become part of the leading software team producing 
software for the worlds fastest micro. 





































REAL TIME SOLIDS MODELLER 


Silicon Vision has now released its rewritten Real Time Solids Modeller for the Archimedes. 

Mike Williams Investigates. 


Silicon Vision is a company which has 
already established Itself in the CAD field with 
Its software for the BBC micro. Now the 
company has released a completely new 
version of its Real Time Solids Modeller for the 
Archimedes. 

The large and impressive packaging 
contains just a single disc and a 45 page 
manual. In fact, the software consists of two 
separate components, the SolidCAD Design 
System for creating and editing 3D objects, and 
the Real-Time Graphics Language for 
animating 3D objects. These can be purchased 
separately if required. We win deal first with the 
design system. 
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Constructing a simple 3D object 


As with other 3D CAD systems (Euclid from 
Ace Computing for example - see review in 
RISC User Volume 1 Issue 8), the SolidCAD 
Design System shows four separate views on 
the default screen, plan, front view, side view 
* and 3D projection. There is also a menu to the 
right of the graphics area, and a two tine 
display of Information at the foot of the screen. 

The main menu list consists of Edit, Panel, 
Style, Tools, Load and Macro. When any main 
menu option is selected a subsidiary menu also 
appears at the right of the screen, often 
including relevant parameters which can be 
changed with the mouse. 


The software is very largely mouse 
controlled, but SolidCAD also responds to a 
number of single key commands, and so-called 
command line options for controlling the 
drawing environment. Although it might be felt 
that a wholly mouse controlled environment 
would be better, it works well in practice, and 
has the advantage that the commands can be 
used to create descriptions of drawings using a 
word processor, and these descriptions may 
then be EXECed into the package. 

As with any 3D system it takes quite some 
time to become familiar with the four screen 
views, and their relationships to each other. The 
X-Y plane is used for the front elevation, with 
the Z axis providing depth (and both 1st and 3rd 
angle projections are supported). Ail drawing 
takes place in one of the three 2D views, and is 
immediately reflected in the display of the other 
views. All four views can be zoomed in and out, 
and the image translated up, down, left or right. 
The 3D projection can also be rotated about 
any of the three axes. The current state of all 
these parameters can be displayed by selecting 
the Panel option from the main menu. 

CREATING 3D OBJECTS 

Objects are built up from facets (faces) that 
can be drawn in any plane view using a rubber¬ 
banding technique. Closed objects can be 
automatically completed by pressing f F. In 
addition, any face can be drawn to form the 
basis of a solid by extrusion or by rotation . 
Extrusion forms a solid using the face as a 
cross-section. The user determines the 
direction and extent of the extrusion. Perhaps 
the simplest example is the extrusion of a 
square to form a cube. 

Solid objects can also be created by rotating 
a plane face about an axis. The user can 
control both the step size to be used and 
whether a full or partial rotation is required. With 
a suitable cross-section, a torus (or doughnut 
shape) can be readily formed for example. 

COLOURING AND SHADING 

The Style menu controls the way in which 
objects are displayed on the screen. The 
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default is for a complete wire frame object, 
which has the merit of being fast. The Surface 
option shows a similar wire frame view, but with 
hidden line removal . A number of additional 
options (catering for both convex and concave 
shapes) allow ail the faces of 3D objects to be 
coloured, giving a really solid appearance. 

SolidCAD can be used in mode 12 {16 
colours) or mode 16 {256 colours), and of 
course with multi-sync modes 20 and 21, and 
the current drawing colour selected from a 
colour menu. There is also a smooth shading 
option, which introduces shades of the selected 
colour, but I found considerable trial and error 
seemed to be necessary, adjusting the various 
lighting parameters, to obtain a pleasing result. 
Smooth shading transforms a facetted object 
into one with much smoother contours. The 
process only works sensibly in mode 12 if a 
grey tone set is selected (:GREYMAP), but 
similar monochrome shadings can be produced 
in other colours {:BLUEMAP, :REDMAP etc,). 
Mode 15 (and modes 20 and 21) give true 
colour shading. 

MACROS 

A macro allows an object defined on the 
screen to bo saved for future use. The object 
can then be rescaled and rotated, and 
positioned as required. Thus a complete 
display can be created from a variety of 
separate building blocks , each created and 
saved separately, 

REAL-TIME ANIMATION 

The Real-Time Graphics Language is 
supplied as a module which you must bad 
before use. This provides over 40 SYS calls 
(SW1 calls for machine code programmers) 
which can be used in your own Basic 
programs, Silicon Vision also provide four 
demo programs on the disc. The SYS call 
format may be less familiar to many Basic 
programmers, but in practice provides simpler 
and more flexible parameter passing than, say, 
star commands 

The SYS calls in effect allow the selection 
of projection (viewpoint) and style of 
presentation to be changed continuously from 
within a program to produce an animated 
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display. This has a lot of potential, and is the 
subject of further development by Silicon Vision 
in the form of a Film Maker package. 



Using the sweep option 


DOCUMENTATION 

I am sure that any software package that is 
concerned with creating, editing and 
manipulating 3D objects will take much practice 
to use with ease. Thus the documentation has 
a vital part to play with any such product, 
particularly for those less used to 3D design. 

The original manual is quite brief in its 
coverage of the software, but is now, 
fortunately, to be supplemented by a much 
more extensive tutorial manual with extra 
examples, as a result of feedback from existing 
users. This will be supplied as part of the 
package for all future purchasers, and existing 
purchasers who have registered with Silicon 
Vision will receive a copy free of charge. No 
copy was available at the time of wriring this 
review. 

Silicon Vision also relies on a number of 
■README' files on disc to document the latest 
features of the package. While this is an 
excellent way of ensuring that a purchaser has 
the latest software features (and information on 
their use), I feel that too much reliance has 
been put on this form of documentation. Even 
the inclusion of photo-copies of these files 
would make the information they contain more 
readily accessible. 
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REAL TIME SOLIDS MODELLER 


The documentation of the Real-Time 
Graphics language (part of the original manual) 
gives no simple example programs to show 
how different SYS calls could be combined to 
produce worthwhile animation effects. Finally, 
many of the available keyboard commands 
appear only In a two page summary at the end 
of the manual {and many others don't appear at 
all). There is also, regretabiy, no index to the 
existing manual. The good news is that Silicon 
Vision says that a new version of this manual 
will be produced when current stocks are 
exhausted. 

CONCLUSIONS 

This software provides a powerful 3D 
modelling system, following as it does several 
year’s of similar software development on the 
BBC micro. And I have certainly not mentioned 
all the facilities available. I do not feel however, 
admittedly on a relatively short trial, that the 
software is not quite as easy to use as it might 
be, and the lack of better examples on disc 
inhibits rather than encourages progress in the 
early stages of learning. 


The documentation, which until now has 
been less than adequate, looks certain to be 
improved substantially in the very near future 
This Is good news for all users, as without 
better documentation, those new to 3D design 
In particular would find learning the use of the 
Real Time Solids Modeller harder than it need 
be. 

The Real-Time Solids Modeller is certainly a 
powerful piece of software, which is set to reach 
a much wider audience with the advent of much 
improved documentation. 


Product 

Real Time Solids Modeller 

Supplier 

Silicon Vision 

Signal House, Lyon Road, 

Harrow, Middx HA1 2AG. 

Tel. Ot-422 2274, 01-861-2173 

Price 

£89.95 inc. VAT 


(SotldCAD only £49*95, upgrade \o 

Real Time Graphics Language £40.D0) 
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IN BROMLEY 

AUTHORISED ACORN DEALERS ^ 

We offer full technical backup, service and advice as well as 
a comprehensive range of software and hardware 
for your Archimedes. If you have a problem - we can 

help you. 

Call in for a software or hardware demonstration, 
or phone for prices and availability 

Data Store 


6 Chatterton Road, Bromley, Kent 
Telephone : 0J-460 8991 (closed Wednesdays) 







A Sixteen-Colour Fader and a Textured Spirograph 


Sty ^.eettyen '24JSite 

This program contains procedures which 
allow you to fade any image up and down in the 
16 -colour modes. 

If you run the program, a sequence of 
randomly coloured ellipse-based patterns will 
be displayed. Each wilt fade up from black, and 
then fade back down before the next appears. 
Although the patterns are pleasant to look at, 
they are only incidental and serve simply to 
illustrate the fades. 



Pattern used by the fader program 

To use the fade procedures in your own 
program, you will need to replace the two 
procedures PROCscreenPalette and 
PRQCgeneratePattern, The first establishes 
the palette which will be used with the display. 
In the present example, a random palette is 
used. Your version of PROCscreenPalette 
should set up your own palette. The second 
procedure places the image on the screen. In 
the current program, a random pattern is 
drawn, but you might replace this with a 
‘ScreenLoad to load a pixel-based image, or 
whatever. 

The program’s three procedures 

PROCstorePalette. PROCfadeln and 


PROCfadeOut do all the work. The first stores 
the current palette in the array col%(ij} t and 
then sets all physical colours to black. 
PROCfadeln brings the palette up from black to 
the stored values, while PROCfadeOut takes it 
back to black. 

10 REM >Fader 

20 REM Program Smooth Screen Fade 

30 REM Version A 0.03 

40 REM Author Ledger White 

50 REM RISC User March 1989 

60 REM Program Subject to Copyright 

70 : 

80 ON ERROR MODE 3 :PRINT REPORTS;" G 
line n ; ERL:END 

90 DIM col%(15,2) 

100 MODE 9:OFF 
110 X=RND(-TIME) 

120 REPEAT 

130 PROCscreenPalette 
140 PROCstorePalette 
150 PROCgeneratePattern 
160 PROCfadeln 
170 FRGCwait(200) 

180 PROCfadeOut 
190 UNTIL FALSE 
200 : 

210 DEFPROCscreenPalette 
220 FOR X%—1 TO 15 

230 COLOUR X%,16*KND(15),16*RND(15),16 
*RND(15) 

240 NEXT 
250 ENDPROC 
260 : 

270 DEFFROCgeneratePattern 
280 GCOL 3,RND(15) 

290 Z%=RND(30):M%=45Q 
300 FOR E=ll-25 TO 180 STEP 11,25 
310 ELLIPSE FILL 640*512,2%,M%,RAD(E) 
320 NEXT 

330 GCOL 3,RND(15) 

340 Z%=RND(10G};M%—250 

350 FOE E=22 * 5 TO 180 STEP 22,5 

360 ELLIPSE FILL 640,512,Z%,M%,RAD(E) 

370 NEXT 

380 ENDPROC 

390 : 

400 DEFPROCstorePalette 
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410 FOR logcol%=0 TO 15 
420 SYS "OS_ReadPalette",logcol%,16 TO 
,,palette 

430 col% (logcol%,2)=palette»>24 
440 col% (logcol%, l) = (palette»>16) AND 
&FF 

450 col% (logcol%,0) = (palette»>8) AND 
&FF 

460 COLOUR logcol%,0,0,0 
470 NEXT 
480 ENDPROC 
490 : 

500 DEFPROCfadeln 

510 FOR x=0.0625 TO 1.01 STEP 0.0625 
520 WAIT 

530 FOR Y%=0 TO 15 

540 COLOUR Y%,COl%(Y%,0) *x,col%(Y%,1)* 
x,col%(Y%,2)*x 
550 NEXT 
560 NEXT 
570 ENDPROC 
580 : 

590 DEFPROCwait(delay%) 

600 T%=TIME 
610 REPEAT 

620 UNTIL TIME>T%+delay% 

630 ENDPROC 
640 : 

650 DEFPROCfadeOut 

660 FOR x=0.9375 TO -0.01 STEP -0.0625 
670 WAIT 

680 FOR Y%=0 TO 15 

690 COLOUR Y%,col%(Y%,0)*x,col%(Y%,l)* 
x,col%(Y%,2)*x 
700 NEXT 
710 NEXT 
720 CLS 
730 ENDPROC 

"Tftc&e *h94UH<**iy&i 
This very short program produces some 
quite stunning effects. It first creates a small 
sprite containing the 256 colours of a mode 13 
screen. This is then plotted on the screen on 
the locus of a circle, which is itself turning 
around the inside of a larger ring. Parameters 
are chosen randomly, and each press of the 
space bar creates a new pattern. A very wide 
variety of effects is generated, though no 
screenshots will do them justice, because even 


if they convey the texture of a particular 
pattern, they can give no idea of the rippling 
movements created as the program runs. 



Example spirograph 


10 REM >SpiroGrph 

20 REM Program Spirograph Visuals 

30 REM Version A 1.00 

40 REM Author Mike Ironmonger 

50 REM RISC User March 1989 

60 REM Program Subject to Copyright 

70 : 

80 MODE 13:OFF 
90 X%=0:Y%=0 
100 FOR C%=0 TO 63 

110 FOR T%=0 TO 3 

120 GCOL C% TINT T%*64 
130 POINT X%,Y% 

140 Y%+=4:IF Y%=64 Y%=0:X%+=4 

150 NEXT:NEXT 

160 MOVE 0,0:MOVE 60,60 

170 *SGET block 

180 *SCHOOSE block 

190 : 

200 ORIGIN 610,482 

210 REPEAT 

220 CLS:S%=RND(200) 

230 A=0:B=PI*RND(1):C=0:D=B*RND(1) 

240 REPEAT 

250 X%=250*SIN(A):Y%=250*COS(A) 

260 PLOT &ED,X%+S%*SIN(C),Y%+S%*COS(C) 

270 A+=B:C+=D 

280 UNTIL INKEY$(0)<>”" 

290 UNTIL FALSE rrn 
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PIPEDREAM 

POWER AT YOUR FINCERTI PS 

PIPEDREAM 

o The best word processor for the Archimedes. It has dynamic 
on-screen page breaks, multi-column text and 'live' embedded 
numbers and calculations. 

o The fastest and most powerful spreadsheet for the Archimedes It 
can sort, format text around numbers and store and quickly 
recalculate large models 

o The most flexible database for the Archimedes It can store a huge 
number of fields, search, sort and select records and have fields 
which are calculated from other values. 

o Complete integration of word processor, spreadsheet and 

database - no need to exchange data between several programs. 

o A mail-shot program which can store names and addresses, write 
the letter to send to them and selectively mail to each one, 
including calculations. 

o Ideal for writing invoices, statements and estimates: the text and 
figures can fit easily into a pre-designed form - and, of course, the 
figures are 'live'. 

o An excellent way to record customer or sales information keep a 
database of sales leads, sort it on different criteria, produce the 
required totals and select and print out the key information. 

o Compatibility with 4 different computers the BBC Micro, the 
Acorn Archimedes, the Z88 and the IBM PC 

o A pull-down menu and help system to make it easy for you to get 
started. 

o Built-in file transfer with PipeDream on the portable Z88 so that 
you can continue work away from your main computer. 

SPELLCHECK 

o PipeDream Spellcheck is now available, with a dictionary of 
93,003 words and the ability to check over 40,000 words per 
minute on the Archimedes. 


VIEW PROFESSIONAL 

o The BBC Micro version of PipeDream which provides complete 
file compatibility with PipeDream and with the Z88 and which 
shares many of PipeDream s features. 


PipeDream costs only £99 00pk& VAT. View 
Professional £60 00plus VAT and SpellCheck 
£43 00plus VAT 

To order PipeDream, View Professional or 
SpellCheck, or to find out more, call us on 0954 
211472 Vbu can pay by VISA or Access try 
phoning us with your card number 3L E3 



fOA A mil WOCHURl. COMPLt T£ AND SIND THIS COUPON 

PipeDream □ View Professional □ 

Name----— 

Address--—..... 


•X • 

nuaro 


Post Code 


COLTON SOFTWARE. BROADWAY HOUSE 
149 151 ST NEOTS ROAD. HARDWICK. 
CAMBRIDGE CB3 7QJ ENGLAND 
FAX (0954)211607 





RISC USER TOOLBOX (8) 


David Spencer completes the current Toolbox series with four final commands. 


This month we add commands to search 
disc files for a given byte, 32-bit word, or 
character sequence; and also a useful help 
command. 

ENTERING THE PROGRAM 

This month's listing should be entered in 
exactly the same way as for previous ones, 
ensuring the program has not been 
renumbered. Save the source code program 
and run it. This assembles and saves the 
Toolbox module which can then be loaded by 
typing QUIT followed by TOOLBOX. 

HELP 

The first new command is invoked using 
‘TOOLS, or ‘HELP TOOLS. This lists out all 
the commands that the RISC User Toolbox 
accepts. More details of each command can be 
found using *HELP <command name>. 

DISC SEARCHING 

There are three commands for searching 
disc files. These are: 

*D£EARCHB <byte>... <filenams> 
[<pathname>] [V][C] 

*D3EARCHW <word>,.. <filename> 
{<pathname>] [V][C] 

*DSEARCHS <string> <filename> 

[<pathname>] [Vj[C] 

They are used to search for byte sequences, 
32-bit word sequences and character strings 
respectively. 

All these commands have a similar syntax. 
Each starts with the search data, which is either 
a series of bytes or 32-bit words (both In hex) 
separated by spaces, or a character string 
enclosed in quotes for ‘DSEARCHS. Next is a 
wifdcarded filename that specifies which files to 
search, and an optional pathname to show 
where the search is to start. Finally, there can 
be up to two qualifiers: 

V Display name of each file as it is 
searched. 

C Ask for confirmation before 
searching a file. 

The commands will search the directory tree 
from the starting point specified, examining files 
that match the wildcarded filename given. If the 


0 option is used, you are asked whether each 
match should be searched or not. You can also 
at this point choose to stop confirming for each 
file by pressing Q (for Quiet), or to abort the 
search by pressing A. As each file is searched, 
it is loaded into application memory. Therefore, 
any program in memory is lost, and should be 
saved first. 

Here are some examples of the use of 
these commands: 

*D SEARCH B 9F 5 1A "EDIT" S.UTILS 

to search for the byte sequence 9F,5,1 A in the 
file $.UTILS,EDIT. Note the use of quotes to 
stop the 'ED' of 'EDIT being interpreted as a 
fourth byte to search for. 

*DSEARCHW FFFF 0000 PROG* ADFS:$ VC 
to search for the word sequence FFFF, 0000 in 
all files with names beginning PROG' on the 
current disc. Additionally, confirmation is asked 
before searching each file, and the name of 
each file is printed as it is searched. 

*DSEARCHS "Hello" * "" C 
to search for the word 'Hello* in all files starting 
from the current directory. Again, confirmation 
is sought before searching each file. 

Note that if any qualifiers are given without 
a pathname, then "" must be used to show that 
it has been omitted, as in the last example. 

For each match found, the name of the file 
is printed along with the position of the match in 
hex. Escape can be used to stop the search at 
any time, although it might take a few seconds 
before the program exits. 

RISC OS 

A number of minor changes are necessary 
in order to make the RISC User Toolbox 
function correctly with RISC OS. These will be 
covered in a future update which we expect to 
include in the next issue. 

LONG LIVE TOOLBOX 

We have come to the end of the RISC User 
Toolbox for the time being. However, its flexible 
design means that further updates can be 
added at a later date, and we would still like to 
hear from members with any ideas which they 
would like to see included. 
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RISC USER TOOLBOX 


251 SWI "OSJfriteS" 

252 EQUS "The RISC User Toolbox has be 
en installed.":EQUW &D0A 

253 EQUS "Use ‘TOOLS or ‘HELP TOOLS fo 
r a list of commandsEQUW £D0A:EQUB 0 

261 .gettaba 

262 ADR R3,tab:MOV PC,R14 

359 EQUS "Tools":EQUB 0 

360 ALIGN:EQUD toolc:EQUD &20FFOOOO 

361 EQUD 0:EQUD toolc 

362 EQUS "DSearchB":EQUB 0 

363 ALIGN:EQUD dsb:EQUD £FF0002 

364 EQUD dsbsyn:EQUD dsbhlp 

365 EQUS "DSearchW":EQUB 0 

366 ALIGN:EQUD dsw:EQUD &FF0002 

367 EQUD dswsyn:EQUD dswhlp 

368 EQUS "DSearchS":EQUB 0 

369 ALIGN:EQUD dsc:EQUD &FF0002 

370 EQUD dscsyn:EQUD dschlp 

1448 .dsbhlp EQUS "‘DSearchB searches s 
elected disc files for the given byte se 
quence.":EQUB 13 

1449 .dsbsyn EQUS "Syntax: DSearchB <by 
te>... <filename> [<pathname>] [V) [C] M : 
EQUB 0:ALIGN 

1450 .dswhlp EQUS "‘DSearchW searches s 
elected disc files for the given 32-bit 
word sequence.":EQUB 13 

1451 .dswsyn EQUS "Syntax: DSearchB <wo 
rd>... <filename> [<pathname>] [V] [C] M : 
EQUB 0:ALIGN 

1452 .dschlp EQUS "‘DSearchS searches s 
elected disc files for the given charact 
er string.":EQUB 13 

1453 .dscsyn EQUS "Syntax: DSearchS <st 
ring> <filename> [<pathname>] [V] [C]":E 
QUB 0:ALIGN 

6870 CMP R3,14 

7210 .se3 ADD R4,R12,#256:BL swil:BEQ s 
e5 

14870 BNE nohash:CMP R3,#0:MOVEQ R3,#l 

14871 MOVNES R3, #0:B ma 

14872 .nohash EOR R3,R2,R3 

14880 AND R3,R3,#£DF:.ma CMP R3,#0 
15480 : 

15490 .toolc STMFD R13!,{R14) 

15500 MOV R0, #475:SWI "OS_Byte" 

15510 STMFD R13!, (R1}:SWI filOE 
15520 SWI "OS_NewLine" 

15530 SWI "OS_WriteS" 

15540 EQUS "The RISC User Toolbox module 
offers the following commands:" 

15550 EQUW £D0A:EQUB 0 
15560 BL gettaba 

15570 .toolc2 MOV R0,R3:SWI "OS_Write0" 
15580 ADD R3,R0,#19:BIC R3,R3,#3 
15590 LDRB R0,[R3]:CMP R0,#0 
15600 BNE toolc25:SWI "OS_NewLine" 

15610 LDMFD R13!,{Rl}:TST Rl,#4 


15620 SWIEQ £10F:SWI "OS_WriteS" 

15630 EQUS "Use ‘HELP <command> for deta 
ils of individual commands." 

15640 EQUW £D0A:EQUB 0:LDMFD R13!,{PC} 

15650 .toolc25 SWI £120 

15660 MOV R0,#686:SWI "OS_Byte" 

15670 CMP R1,#101:SWICS "OS_NewLine" 

15680 BCS toolc2 

15690 .toolc3 SUBS R1,R1,#20 

15700 BCS toolc3 

15710 .toolc4 SWI £120 

15720 ADDS R1,R1,#1:BNE toolc4 

15730 B toolc2 

15740 : 

15750 .dsw MOV R3,#4:B dsb2 
15760 .dsb MOV R3,#l 
15770 .dsb2 STMFD R13!,{R14] 

15780 LDR R12, [R12]:ADD R5,R12,#fi400 
15790 .getseq MOV Rl,R0:MOV R4,#16 
15800 .getseq2 MOV R0,#16 
15810 CMP R3, #4 :ORRNE R0,R0,#1«30 
15820 ORR R0,R0,#1«31 
15830 SWI "OS_ReadUnsigned" 

15840 STR R2, [R5,R4]:ADD R4,R4,#4 
15850 SUB R1,R1,#1 
15860 .getseq3 ADD R1,R1,#1 
15870 LDRB R2,[R1]:CMP R2,#32 
15880 BEQ getseq3:CMP R2,#fi30 
15890 BCC getseq4:CMP R2,#ASC"G" 

15900 BCS getseq4:CMP R2,#£3A 
15910 BCC getseq2:CMP R2,#ASC"A" 

15920 BCS getseq2 

15930 .getseq4 STR R4,[R5,#4] 

15940 CMP R2,#32:ADRCC R0,nofile 
15950 LDMCCFD R13!,{R14) 

15960 ORRCCS PC,R14,#1«28 
15970 .dscont MOV R0,#0 
15980 STRB R0,[R12,#£402] 

15990 STMFD Rl 3!,{R1):SWI "OS_GetEnv" 
16000 SUB Rl,Rl,#£8000 
16010 STR Rl,[R12,#£408] 

16020 LDMFD R13!,{Rl}:MOV R0,R1 
16030 MOV R2,#1«29:SWI "OS_GSInit" 

16040 ADD R5,R5, #512 
16050 .gfnn SWI "OS^GSRead" 

16060 MOVCS Rl,#0:STRB R1,[R5],#1 
16070 BCC gfnn:SUB R0,R0,#2 
16080 TST R2, #1«28 : SUBNE R0,R0,#1 
16090 .gfnn2 LDRB R1,[R0,#1]! 

16100 CMP Rl,#32:BEQ gfnn2:MOV R4,R0 
16110 MOVCC R2,#0:BCC gopdone 
16120 MOV R2,#1«29:SWI "OS_GSInit" 

16130 .skpath SWI "OS_GSRead":BCC skpath 
16140 TST R2,#l«28:SUBNE RO,R0,#l 
16150 MOV R2,#0:SUB R0,R0,#1 
16160 .gop LDRB R1,[R0],#1: CMP Rl,#32 
16170 BEQ gop:BCC gopdone:AND R1,R1,#£DF 
16180 CMP Rl,#ASC"V":ORREQ R2,R2,#1 
16190 BEQ gop:CMP R1,#ASC"C" 
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16200 ORREQ R2, R2, # 2:BEQ gop:B bqual 
16210 .gopdone STRB R2,[R12,#1024] 

16220 STRB R3,[R12,#1025] 

16230 ADR RO,getout:STMFD R13!,(RQ] 
16240 STR R13,[R12, #S3FC] 

16250 MOV R0,R4:ADR Rl,serrou 
16260 BL swill:ADD R13,R13,#4 
16270 .getout LDRB R0,[R12,#4402] 

16280 CMP R0 r #0:LDMEQFD Rl3!,(PCr 
16290 SWI "OS^Exit" 

16300 .dsc STMFD R13!,(R14} 

16310 LDR R12,[R12] 

16320 MOV R2,#1«29:$WI "OS_GSlnit" 
16330 ADD R3,R12,#256 
16340 ,dsc2 SWI *OS_GSRead" 

16350 MOVCS Rl,#0:STRB Rl,[R3},#1 
16360 BCC dsc2:TST R2,#l«28 
16370 SUBNE R0,R0,#1:SUB R0,R0,#2 
16380 STMFD R13!, (R0) 

16390 ADD R0 r R12,#256 

16400 ADD R1,R12,#S410:BL swi2 

16410 LDMFD R13I,(Rl):MOV R3,#0 

16420 .ssss LDRB R0,[Rl,#1J! :CMP RG,#32 

16430 BEQ ssss:B dscont 

16440 : 

16450 .serrou STMFD R13‘,(RQ-R1} 

16460 ADD R0, R0, #20:ADD R1,R.12,U600 
16470 BL swil3;CMP R3,#0 
16480 LDMNEFD Rl3!, {R0-R1,PC} 

16490 ADD R2,R12,#255 

16500 -coneat LDRB R3,[R2,#1}! 

16510 CMP R3,*0;BNE concat 

16520 STMFD R13!,(R2):ADD R3,R12,#256 

16530 CMP R2,R3:BEQ nodot 

16540 LDRB R3, [R2,#-l]:CMP R3,*A$C";" 

16550 MOVNE R3, #fi2E: STRNEB R3,[R2],#l 

16560 - nodot 

16570 LDR RG,[R13,#4J:ADD RO,RO,#20 
16580 + concat2 LDRB R3,[R0],#1 
16590 CMP R3,# 0:STRB R3, [R2J,#1 
16600 BNE concat2:LDR R0,[R13,#4] 

16610 LDR Rl,[RG,#16]:CMP Rl, 12 
16620 BEQ nosthis:LDR Rl,[R0 r f8] 

16630 LDR RO,[R12,#S4G8]:CMP Rl,R0 
16640 BCC lenok:SKi "OSJiriteS" 

16650 EQUS 'Tile ":EQUB 0 

16660 ADD R0,R12, #256 

16670 SWX "OSJWriteQ "i SWI "OS_WriteS* 

16680 EQUS M too long - skipping," 

16690 EQUW &D0A:EQUB 0:B nosthis 
16700 .lenok STR Rl,[R12,#&4QC] 

16710 LDRB. R0, [R12,#&400] :TST R0,#2 
16720 BEQ noconf: SWI "OS_WriteS" 

16730 EQUS "Search file ": EQUB 0 
16740 ADD R0, R12,#256:SWI "OSjfriteO" 
16750 SWI "OSWriteS" 

16760 EQUS " U/N/Q/A) ? tr : EQUB 0 
16770 .kkget SWI "OSReadC" 

16780 BCS abort:AND R0,RO,UDF 


16790 CMP RQ,#ASC"N";BL£Q pnl 
16800 BEQ nosthis:CMP R0,#ASC"Y" 

16810 BLEQ pnl:BEQ noconf 
16820 CMP R0, #ASC"A": BLEQ pnl 
16830 BEQ abort:CMP R0,#ASC"Q" 

16840 BNE kkget:BL pnl 
16850 LDRB RQ r [Rl2,#S4G0] 

16860 BIC R0,RO,#2:STRB RO, [RI2,#&4Q0| 
16870 .noconf LDRB R0,[R12,#&400] 

16880 TST R0,#1:BEQ notell 
16890 SWI "OSWriteS* 

16900 EQUS "Searching file ":EQUB 0 
16910 ADD R0,R12 r #256:SWI M OS_WriteO" 
16920 SWI "OSNewLine" 

16930 -notell ADD R1,R12,#256 
16940 MOV R2,#68000:MOV R3,#0 
16950 MOV R0,#6FF:SWI "OS_File" 

16960 MOV R0,#1:STRB RO,[R12,#4402] 

16970 LDR R2,[R12,#S40C] 

16980 MOV R0,#48000:ADD R1,R2,R0 
16990 LDR R2,[Rl2,*fi404J 
17000 SUB R2,R2,#i6:MOV R2,R2,LSR 12 
17010 LDRB R3, [R12,#£401] 

17020 CMP R3, #4:BICEQ R1,R1,#3 

17030 CMP R3, #0:BEQ smsl 

17040 ADD R4,R12,#4410 

17050 .msl BL swil:BNE nogthis 

17060 BL fndprt 

17070 ADD RO,RO,R3:B msi 

17080 .smsl LDRB R0,[R12,#£410] 

17090 LDR R2, [R12, H4QC] :SUB R2,R2,RG 

17100 ADD R2,R2,I&800Q:MOV RQ,#fiBG0Q 

17110 ADD R1,R12,#&410 

17120 . gmsl2 BL swi3:BEQ smsl4 

17130 -smsl3 ADD R0,R0,ll:CMP RQ,R2 

17140 BNE sms 12:B nosthis 

17150 . smsl4 BL fndprt:B smsl3 

17160 .fndprt STMFD R13f,|R0-R3, RI4] 

17170 SWI "OS_WrxteS": EQUS "Match found 

in file 11 : EQUB 0 

17180 ADD R0 r Rl2,#256;SffI "OSWriteQ" 
17190 SWI "OS_WriteS":EQUS " at offset & 
":EQUB 0 

17200 LDR Rl,[R133:SUB R1,R1,#68000 
17210 BL adrprt:SWI "OS_NewLine" 

17220 LDMFD R13!,{RG-R3,PC] 

17230 ♦abort LDR R13,[R!2,#s3FC] 

17240 LDMFD Rl3!,(PC} 

17250 .nosthis LDMFD R13!,(R0) 

17260 MOV Rl,#0:STRB Rl,[R0] 

17270 LDMFD R13!,{R0-R1,PC} 

17280 .pnl STMFD R13!,(R14) 

17290 SWI "OS WriteC":SWI "OSNewLine" 

17300 LDMFD Rl3!,{PC) A 

17310 .nofile EQUD 0 

17320 EQUS "Missing Filename" 

17330 EQUB 0 
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PRODUCTS FOR THE 1990's 


NEW PRESENTER STORY 

The ultimate in Business Presentation software. Turn your Archimedes into a too / to project combined 
images of Text, Logos, Graphs, Digitised & Video Pictures to illustrate your presentations more clearly. Many 
special screen features are included such as vertical and smooth scrolling and bouncing It can be used with 
most makes of RGB projectors or you can use your Archimedes monitor for smaller Presentations 
PRESEN TER STOR Y is available for Business applications now. Education and Media/ Video versions will be 
available soon. R/SCOS compatible 
£199.00 + VAT 


P RE SENTER 

The established presentation package for Archimedes users in schools and businesses alike. Colour 3-D 
Bar-, Line- and Pie- charts and graphs can be made quickly and easily in the Acorn WIMP environment. 
These chans and graphs can be printed on FX-compatible and fntegrex colour printers and also on Plot mate 
plotter. Alternatively, they can be poned into other packages, such as 1st Word Plus, An/san & Graphic 
Writer. RISCOS compatible. 

£24.95 + VAT 


NEW CONTROL PANEL 

^edabout the *Con figure comands ? With Control Panel there 7s no need to worry Use Control Panel to 
set the right Archimedes ' configuration for all your application software. You can then Save and Load the 
configuration settings of your choice for use at later dates . Control Panel also includes a utility to build 
configuration files into program boot files. Fully w/mp-driven with constant real-time help screen. 

£14.95 + VAT 


NEW COLOUR ^CONVERTER 

Do you want to capture colour images onto your Archimedes screen? The Colour Converterpodu/e running 
with the Watford Digitiser allows full colour images to be captured and saved as screens or sprites. The 
package also includes new Dithenng Software which will give you greatly enhanced near-television quality 
pictures, using an effective palette of256,000colours! The Colour Converter Y* Width Podu/e and Software 
is available now. 

£169.95 + VAT 


NEW A I M (Archimedes Image Manager) 

Public Domain Image Processing software from Delft University which will he contrast and 

sharpen blurred images that have been digitised Many varied uses—m education, industry and the home. A 
multisync monitor is required in order to give the necessary resolution. 

£9.00 + VAT 




VISA 

and 

ACCESS 


All Lingenuity products are available direct or from good Acom dealers. 
Educational discounts and site-licences are available. 

For further details please contact us on 098 685 477 or write to 

i: _OiO -in /n*o nnv 








A survey of the games software scene for the Archimedes complied by Peter Rochford. 


When the Archimedes was first launched 
some eighteen months ago, there was littPe 
software around to go with it, least of all games, 
if you wanted to thrash a few aliens with your 
32-bit wonder machine, you had no choice 
other than Lander on the Welcome disc. 

The first games release came from Superior 
Software in the shape of Zarch (£19.95), an 
enhanced version of Lander featuring extra 
graphics and sound. Following Zarch, Superior 
then released Conqueror (£24.95), a game that 
owes much to the graphics in Zarch. It features 
a not dissimilar 3D scrolling landscape, but 
used now in a tank battle simulation. It was OK 
if you had a taste for that kind of thing, but the 
Zarch-like graphics gave that feeling of deja vu. 

Since those two games were released 
nothing much has appeared until the last few 
months, when several new games have 
surfaced. 

Minerva has done much to support the 
Archimedes with serious software, and they 
have also released several games too. Their 
first was Minotaur (£14.95), an unremarkable 
3D maze-type game that involves plodding 
round seemingly endless corridors trying to find 
a way out Graphically abysmal, and about as 
exciting as a wet Sunday afternoon. Sorry 
Minerva! 

Their follow-up release was Missile Control , 
a game that appeared in the arcades years 
back, with versions for many machines 
including the Beeb. The game involves 
destroying missiles that travel down the screen, 
aiming to destroy the cities below. The graphics 
in this are crude when you consider what can 
be done on the Arc, and playing the game turns 
out to be just as much a mega-yawn as 
Minotaur. 

Redemption for Minerva comes in the shape 
of one of their latest releases, Orion . This is a 
much enhanced version of the classic arcade 


game Defender that appeared on the Beeb as 
Planetoid. It is a horizontally scrolling, shoot- 
em-up game, where you have to save the little 
men on the planet's surface as they get 
abducted by the aliens dropping down from 
above, at the same time avoiding or destroying 
a whole host of other nasties. Orion is a brilliant 
version of the game with a classy presentation, 
and excellent graphics and sound. Highly 
recommended! 



Freddy's Folly 


Freddy's Foity is another offering from 
Minerva, but aimed at the younger Arc user. 
The game scene is a harbour where your castle 
is built overlooking the sea. The idea is to 
prevent your castle from being bombed by the 
balloons that fly overhead by shooting them 
down with a cannon. You must also destroy the 
ships which are shooting at you as they sail into 
the harbour. The game is preceded by a little 
story that has some rather amusing animated 
sequences as illustration. The whole thing is 
well thought out and nicely implemented, 
although 1 thought the text in the story should 
be left on the screen longer for youngsters to 
read. Otherwise, a good game with lots of 
appeal. 

The latest Minerva game is Jet Fighter, a 
version of yet another computer favourite that 
was most popular on the Spectrum under the 
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name Jet Pac. You have to fly your spaceman excellent. It has delightful graphics and it all 
around the screen collecting parts to construct works beautifully, mostly under mouse control 
a space rocket that will transport you to the The program features a 30,000 word dictionary 

next level for more of the same. It's pretty and digitised speech. Up to six people can play, 

mundane stuff, with graphics comparable to or you can play against the computer: highly 

versions of this game on lesser machines* recommended. 


Impact Games' first and as yet only release 
for the Arc is Quazer, a frantically fast, 
vertically scrolling, death and destruction shoot- 
em-up. The game makes good use of graphics 
with hordes of colourful sprites hurtling down 
the screen accompanied by a host of noisy 
sound-effects. A thoroughly enjoyable and 
frenetic alien bash, with lasting appeal and 
definitely recommended. 

Dabs Press has now entered the games 
software market with Alerion for the Arc. Like 
Quazer, this is a vertically scrolling shoot-em- 
up that is frantic and noisy* The graphics are 
good, and it features digitised sound effects 
too. My own personal preference between the 
two similar games would be Quazer. But 
Alerion is challenging and enjoyable. Worth 
considering if you like this type of thing* 

A totally different kind of offering from Dabs 
is Arcendium, a collection of computer versions 
of four popular board games, Backgammon, 
Reverse Draughts and Quadline (Connect-4)* 
These are nicely written, featuring some neat 
graphics, and are played under mouse control* 
If you like board games then Arcendium is 
worth buying, but be warned, the computer 
plays a mean game! 

Gem Electronics, a new name in the games 
software world, has released two Arc games to 
date. The first is Star Trader ; a strategic space 
adventure that can be likened in some ways to 
Elite, and shares many of its features. 
However, Elite it is not, and the combat 
elements in particular do not in any way 
compare. It is a brave attempt though, and is 
an involved game that can be entertaining and 
absorbing to play. 

The other release from Gem is Word-Up- 
Word-Down, a 3D scrabble game that really is 


Just when you thought that Repton had at 
long last been laid to rest with the final(?) 
uttimate Repton Infinity on the Beeb, up it pops 
again for the Arc as Repton 3 * If you like 
Repton, all well and good, but this is just 
identical to the Beeb versions, and to my mind 
an unwarranted release from Superior. 



Corruption 


Rainbind is a software division of the great 
British Telecom. They have now entered the 
Arc games market, and it is encouraging that 
one of the 'biggies' has sat up and taken notice 
of the machine* They have released two 
adventure games. The first one is Corruption 
(£24.99}, set in yuppie-land where you take the 
role of a partner in a broking firm. The plot is in 
the name of the game - corruption* 

The second game is called Fish! (£24.99), 
with an unbelievably zany plot. You are a 
goldfish and your first task is to escape from 
your bowL Having done so, you are 
transformed into a fish scientist, Mr A. Roach, 
and from then on you are the leader of The 
Project, a secret undertaking to conserve 
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water. You must prevent The Project from 
being sabotaged- Crazy! 

Space does not permit a detailed review of 
these games but take it from me T they are both 
brilliant. From the amazing opening music, to 
the superb graphics and the game-play itself, it 
is all first class stuff. Buy them both! 



Fish! 


Finally, two games from a company called 
Grand Slam. Pacmania is a 3D version of the 
old favourite Pacman. You may stop yawning at 
the thought of more Pacman! Pacmania is a 
whole new slant on the original, and features 
probably the best graphics and music yet on 
the Arc. There are four different 'worlds' to 
negotiate, at ever higher levels of difficulty. The 
animation is truly brilliant from the superb 
4-way screen scrolling to the amusing cartoon¬ 
like features that appear between each level. 

Terramex is the other release from Grand 
Slam. This is an animated graphic adventure 
where you have to travel across deserts and 
through caves, collecting items to help you in 
your search for the mad scientist, who is the 
only person who can save the world from being 
destroyed by a meteorite. The plot may be a bit 
corny, but the game is delightful and amusing, 
it is also very challenging, and this reviewer is 
still struggling! The graphics are truly excellent 
and the game is incredibly addictive. You must 
forgive my gushing enthusiasm for both 
Pacmania and Terramex, but they are of the 


quality Arc owners have been waiting for, and 
do some justice to the machine itself at long 
last. Need I say more! 



Terramex 


COMMENT 

In this survey, I have only looked briefly at 
most of the games yet released for the Arc. In 
the future I hope to provide fuller reviews of 
most major games as soon as they are 
released. There are now good signs that the 
games scene for the Arc is improving at long 
last. Games like the Firebird and Grand Siam 
releases are converted versions of Amiga and 
ST software which is good. If they sell well 
enough I am sure that many more will follow. 
Anything you can do on the ST and Amiga you 
can do just as well or, better on the 
Archimedes. 

Which brings me to my final point. As good 
as Pacmania or Terramex are, and they are the 
best around for the Arc, they still do not exploit 
the full potential of the machine's speed, 
graphics and sound capabilities. The true fact 
is, that until the Arc has sold in even greater 
numbers, sadly no one is going to invest the 
time and money in a mega-game that does. But 
the Arc is selling better than ever now, and the 
future is looking brighter all the time. We live in 
hope. See you soon! 

NOTE: AH games referred to in this survey are 
available from BEEBUG, and at 5% discount to 
RISC User members - see retail catalogue, glj 


RISC User March 1989 


35 










nnulti-TasKino with RJ5C 05 (ran 2 ) 


David Spencer concludes our Introduction to the RISC OS multi-tasking system 
by looking at it from a programmer's point of view. 


Before explaining how the multi-tasking 
system works, we need to understand the 
interaction between the Window Manager and 
a program running in a WIMP environment. The 
key to this is a technique called polling. 

The program must regularly call a routine in 
the Window Manager (via a SWI call) known as 
the polling routine. The Window Manager uses 
this opportunity to perform any of its own 
processing, such as redrawing a drag box, and 
then returns a reason code to the program. 
This reason code informs the program of any 
actions that the Window Manger requires it to 
perform. For example, if a reason code of 3 
was returned, then this would mean that the 
user had clicked on the *Quif box of an open 
window. Before performing any other actions, 
the program must find out which window is to 
be closed, and ask the Window Manager to 
close it. 

Similarly, a reason code of 1 means that a 
window needs redrawing (perhaps because a 
window that was on top has been closed), while 
a reason code of 8 signifies that the user has 
pressed a key, A reason code of 0 means that 
the Window Manager doesn't want any actions 
performing at that point, and the program is 
free to do any processing of its own, for 
example updating the display. Whatever the 
reason code returned from the polling routine, 
as soon as the program has performed the 
necessary action, it must return to the loop that 
performs the polling. 

The net outcome of the polling system is 
that control is bounced backwards and 
forwards between the application program and 
the Window Manager To achieve multi-tasking 
all that is necessary is for the Window Manager 
to pass control to each application in turn. This 
is shown graphically in the diagram, which 
illustrates the multi-tasking of six applications. 
We will take as a starting point the situation 
where App.1 is about to call the polling routine. 
App , 1 calls the Window Manager, much in the 
same way as would happen in a single task 


situation. However, when the Window Manager 
has finished its processing, rather than 
returning to App.1, it instead passes control to 
App.2 , which performs any necessary actions 
and duly calls the polling routine again. 
Subsequently, control is passed to App.3, and 
then App.4 and so on. Finally, when App.6 calls 
the polling routine, the Window Manager will 
pass control back to App.1, with whatever 
reason code applies to App > 1 at that time. 

As far as App.1 is concerned, it has called 
the Window Manager's polling routine, and the 
Window Manager has eventually returned a 
reason code back to it. App. 1 is totally unaware 
of the fact that six other applications have been 
activated one after another, while it was waiting 
for the routine to return. Had we considered 
how any of the other five applications viewed 
what was happening, the situation would be 
unchanged. As far as each application is 
concerned, it is the only one running. 

Therefore, we have achieved our aim of a 
multi-tasking system with very little effort. It 
should also be clear now why the Window 
Manager plays such an important role in multi¬ 
tasking, and why all multi-tasked applications 
run in a WIMP environment. 

MEMORY ALLOCATION 

In a multi-tasking system it is important to 
control the allocation and use of memory. All 
applications running under RISC OS expect to 
have a contiguous area of RAM starting at 
address &80Q0 to use as workspace. In the 
case of applications loaded from a file, they 
actually load at this address and then use the 
memory above them as workspace. Module 
based applications, such as Basic, are free to 
use all the application memory as workspace. 

The amount of application workspace 
available overall is not set directly. Instead, all 
the RAM left over after the areas have been 
allocated for the screen, modules, sprites, etc. 
is used as application workspace. In a single¬ 
tasking environment, only one application is 


36 


RISC User March 1989 







f RISC OS—1 



mulli-TasKinQ LUith RISC OS 


active at a time, and consequently, ail the 
application workspace is allocated to this 
application. 



In a multi-tasking environment, the situation 
is more complicated. The Task Manager 
maintains a pool of free memory, out of which, 
memory can be allocated to tasks. A certain 
quantity of this memory is made available to 
the next application that is started. The user 
can change this allocation via the task display 
window. When a new application is loaded it 
uses a star command to tel! the task manager 
the minimum amount of memory it requires, 
and the maximum that it could use if more was 
available. Provided that the memory set aside 
for the next task is enough, the application will 
be started and allocated the appropriate 
amount of workspace. Some applications can 
change the amount of memory they have while 
they are running. They do this by claiming more 
memory from the free pool when needed, and 
returning it when It is no longer required. An 
example of this type of application is ArcEdit on 
the Welcome disc. When an application is re¬ 
moved, its memory is returned to the free pool 

It is ali very well to allocate seif contained 
blocks of memory to each application, but there 
stilt remains the problem of ensuring that 
whenever an application is actually executing, 
its workspace lies in a block from location 
&8000 upwards. One obvious way would be to 
copy the workspace of the current application 
to somewhere else, copying the workspace for 


the next application down to &8G00, and then 
finally executing the next application. However, 
even with the speed of the ARM, copying a 
large amount of memory wastes a lot of time. 

Luckily, MEMO, the ARM memory controller 
chip, provides a far more elegant solution. 
Instead of mapping addresses directly to 
locations within the physical RAM, MEMO 
supports a concept known as logical memory. 
The actual physical memory is split up into 128 
pages . Therefore, on a 310, each page is 8K 
long, while on a 440 it is 32K. A 305 keeps a 
page size of 8K and only uses 64 pages, rather 
than having a 4K page size. For each page of 
physical memory, it is possible to define where 
it appears in the memory map of the ARM 
processor. The mapping between the logical 
processor addresses and the actual physical 
addresses is controlled by an area of very fast 
memory within MEMC called a Content 
Addressable Memory (CAM). It is by using this 
technique that RISC OS arranges for the areas 
of RAM allocated to the screen, sprites, etc. to 
start at well-defined addresses. 

However, the ability to change the address 
at which a page of memory appears is perfectly 
suited to the task of moving application 
memory. When switching from one application 
to another, RISC OS changes the contents of 
the CAM so that the current application's 
workspace is remapped to an address that is 
out of the way of anything else. The RAM 
pages that belong to the next application are 
then located using a table kept by the Window 
Manager, and the CAM is further changed so 
that these pages are mapped from address 
&8G00 upwards. This achieves the effect of 
moving around large amounts of memory by 
only altering a few locations within the CAM, 
Furthermore, MEMC also allows pages of 
memory to be protected, and RISC OS ensures 
that all application memory not in use at that 
time is protected so that it cannot be written to. 
This means there is less likelihood of one 
application accidentally corrupting the 
workspace belonging to another. 

This ends our introductory look into the 
world of multi-tasking, but we will return to the 
subject in future issues of RISC User. [2J| 
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EXPANSION CARDS 
FOR THE 

ACORN ARCHIMEDES 
COMPUTER SYSTEM 


IEEE488 INTERFACE a full implementation 
of the standard for automatic test and 
measurement systems 

16 BIT PARALLEL I/O two 16 bit input or 
output ports with handshake lines for digital 
control applications 

DUAL RS423 SERIAL INTERFACE for 

communicating with two additional RS423 or 
RS232 devices eg printers, plotters, 
instruments, etc ~ 

12 BIT ANALOGUE I/O in development 

All the above high performance expansion cards are 
supplied with high level software for ease of use and a 
comprehensive user guide. 

Take advantage of Intelligent Interfaces’ expertise and 
purchase a complete Archimedes Computer System. 

Officially appointed Acom Scientific Dealer. 

I Intelligent Interfaces Ltd 

43b Wood Street 
Stratford-upon-Avon 
Warwickshire 
CV37.6JQ 
Tel: 0789 415875 

Telex: 312242 MIDTLX G _ 
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Clares'Toolkit Plus 


Reviewed by David Spencer 


The original Toolkit from Clares was one of 
the first pieces of Archimedes software to be 
released, and has therefore been around for 
nearly two years. Toofkit Plus is the long 
promised, enhanced version of Toolkit, and it is 
this which 1 will look at here. 

EDITORS 

In common with most Toolbox-type 
packages, Toolkit Pius is based around a full 
screen editor that can edit either memory or 
disc contents* The editor can be invoked 
directly using the *MEDIT and *AEDfT 
commands, or indirectly via the search 
commands described below. The editor display 
can be switched between binary* hex, word, 
text or mnemonic format, and the display freely 
scrolled* One very nice feature is the single-line 
assembler that allows ARM mnemonics to be 
assembled directly into memory from within the 
editor 

In addition to the interactive editor display, 
blocks of memory can also be dumped in any 
of the available display formats. This is mainly 
used when dumping memory to a printer. 

FIND COMMANDS 

Toolkit Plus includes a large number of 
search and find commands that can be used to 
search either memory or disc for a given 
sequence of bytes, words, characters or 
mnemonics. When a match is found, the editor 
is entered, enabling changes to be made 
before the search continues* 

MISCELLANEOUS 

There are a number of commands which 
don’t fit into any obvious category. These 
include commands to move and swap blocks of 
memory, and to list out various important 
system addresses, such as that of the current 
error handler. 

Also in this group are commands to list alt 
the SWI calls available in the machine, and to 
convert a SWI name to its corresponding 
number, and vice-versa. These can all be very 
useful, but in some cases only reproduce what 
the operating system already offers. 


GENERAL RUNG SYSTEM COMMANDS 

As well as the disc editor and disc searches, 
Toolkit Plus also provides some general file- 
specific commands, 

‘CATALL, *EXALL and ‘DIRALL all perform 
a cataloguing type function* *CATALL lists all 
the files and sub-directories starting from a 
given place, while *EXALL also lists full 
information on those files, *DIRALL on the other 
hand only lists directory names. 

*APUT and *AGET are used to read and 
write disc sectors directory. They can be useful 
when recovering lost files, or writing a disc 
protection system, though these calls really only 
provide a star command equivalent to an SWI 
call provided by the ADFS* 

There is a command to compact an ADFS 
disc repeatedly until only one chunk of free 
space remains, and another command to verify 
the contents of a file against a block of memory. 
Finally in this category, is a very useful 
command to dump to screen (or printer) the 
contents of a file in any of binary, hex, word, 
text or mnemonic format. 

SCREEN HANDLING COMMANDS 

The last set of commands is connected with 
screen handling. The first two of these are 
•FASTSAVE and TASTLOAD for saving and 
loading screens. These commands are much 
faster than *SCREEIMSAVE and 
*SCREENLOAD, but only work for whole 
screens. This seems more limiting than 
necessary, because the method used by these 
commands will in fact work with any window 
that is the full screen width, rather than just fufl 
screens. The commands *LOADPALETTE and 
*SAVEPALETTE save and load the current 
palette setting. 

HARD DISC ARCHIVER 

This is a utility for backing up hard discs, 
which is effectively separate from the main 
commands, although it is invoked using Toolkit 
Plus commands. The archiver is in fact a Basic 
program which copies the contents of a hard 
disc onto a set of floppies (as many as 27 of 
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them for a full hard disc). The copy is done as a 
series of disc sectors, rather than on a file by 
file basis, and this removes the restriction of 
not being able to back up files longer than 
80QK, The resultant backup consists of two 
parts: the actual data that makes up the files, 
and a backup log showing where the data 
belongs on the hard disc. This log is written 
twice to separate floppies for extra protection. 

Various configuration options can be used 
to determine which files will be archived. It is 
possible to archive only files before a certain 
date/time, or after a certain date/time, or inside 
or outside a particular period of time. You can 
also choose to archive files of just one 
particular filetype. 

The opposite of "Archive is "Restore, which 
restores all the archived files back to the hard 
disc after any disaster. All files must be 
restored at once, it is not possible to restore 
just selected files. 

CONFIGURATION 

Toolkit Plus makes extensive use of the 
"CONFIGURE command to customise its 
operation. For example, default pathnames and 
starting addresses can be set up. Unlike the 
normal configuration options, Toolkit Plus 
doesn't save them in CMOS RAM. Instead, the 
options modify the program directly, with an 
option to save them to disc as permanent 
changes. 

DOCUMENTATION 

The Toolkit Plus manual is very similar to 
that of Toolkit, and indeed any other of Clares' 
products. It is A5 in size, 64 pages long, and 
bound with a plastic comb. The manual starts 
off with details of making a backup copy, 
followed by a summary of the available 
commands, and the syntax of any parameters. 

The next section details ail the 
"CONFIGURE options, followed by a list of the 
editor control keys. Then comes the description 
of the commands. For each command, the 
syntax is given followed by a plain language 
description of what the command does, and 
then an example, a list of possible errors, and 
any extra notes. 


The appendices consist of notes on the 
single line assembler, an explanation of the 
possible error messages, and instructions for 
using the hard disc archiver. Finally, there is a 
fairly comprehensive index. 

One omission from the manual is a list of 
the SW1 calls implemented by Toolkit Plus , l 
discovered by pure chance that there are 
twenty-five of these, and I am sure that at least 
some of them could prove useful in your own 
code. Hopefully, Clares will produce some form 
of technical note covering these. 

The actual packaging of our copy of Toolkit 
Plus was in fact a standard Toolkit box with a 
Toolkit Plus sticker over the name. \ suspect 
that this is only a temporary measure. 

CONCLUSION 

I was rather disappointed with Toolkit Plus. I 
had been led to believe that the new module 
would be a great enhancement over the original 
Toolkit * Instead, the changes are largely 
extensions to the existing features, though the 
hard disc archiver is a new and useful feature. 
Toolkit Plus costs £49.95 inc, VAT, which, 
considering current trends in Archimedes 
software prices, is reasonable* However, users 
of the existing Toolkit , will have to pay £24,95 
to upgrade to Toolkit Pius - a figure that I find 
excessive. 

ff you need a Toolkit package, then Toolkit 
Pius is really the only commercial one 
available, although you could always use our 
very own RISC User Toolbox. I find the 
features of Toolkit Pius useful, and I would not 
resent having to pay £50 for it. But if I had 
already bought Toolkit t l would be very 
reluctant to part with another £25 for an 
enhanced version which many companies 
would offer at a nominal cost to registered 
users. 


Product 

Toolkit Plus 

Supplier 

Clares Micro Systems 


98 Middle wich Rood, 


Rudheath, North wich. 


Cheshire CW9 7DA. 


Tel. (0606) 4651! 

Price 

£49.95 inc. VAT 
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IMM 




/ NOW 
AVAILABLE 

Call for 
full details 


We offer 
a unique 
inspection 
copy service 


Have you 

spent long hours struggling 

with the programming complexities of the brilliant^^^ 
^ Archimedes WIMPS system? 

With ARCHWAY that's all behind you* Now YOU can easily and quickly 
build multi-window programs with pop-up menus, icons, mouse control, 
etc- of a professional quality, 

ARCHWAY provides tools, bricks, mortar and a basic structure. YOU slot 
the final bricks into place and add finishing touches, 

A comprehensive suite of integrated tools lets you define and edit 
windows, menus, icons, dialogue boxes, mouse pointers, sprites, fill and 
line patterns, anti-aliased fonts, short cut keys and much morel You can 
import files (eg ARM machine code and music editor). 

The bricks include an extensive library of functions and procedures 
providing ready access to many of Archimedes' most powerful features. 
An in-depth user guide (300+ pages, ring bound) takes you gently step- 
by-step through a progressive series of program building examples with 
the emphasis on clarity. 

The ARCHWAY run-time package together with £ 79.95 

script shells in BBC BASIC provide the structure, j nc L vat & p/p 

The complete system comes on 4*800k discs (3 tools & 1 run-time). You 
need 1M of RAM to run the tools. One disc drive is sufficient, 

SPECIAL INTRODUCTORY OFFER: No charge for upgrade to the 
extended RISC OS 2.0 version we will release in May 1989, (£99.95) 


VMbimhun z7yo7'° 

4 CLARENCE DRIVE, EAST GRINSTEAD, 

WEST SUSSEX RH19 4RZ Telephone (0342) 328188 


Cheques/POs/offidal orders or Access/Visa number and 
expiry date. 24-hour "phone for Credit Card orders. 
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MAKING USE OF FILE TYPES 


The Arthur and RISC OS operating systems support the use of file types. 
Lee Calcraft explains how they work, and how to use them. 


WHAT ARE FILE TYPES? 

Almost all files created by the Archimedes 
and stored on disc, RAM disc or Econet are 
given a so-called File Type, This is a number 
between zero and 4095 (000“ FFF hex) which is 
used to identify the file, and to determine the 
way in which it will be treated when it is loaded 
or run. Table 1 gives a summary of the major 
tile types. Acorn have allocated types in the 
range &QQ0-&7FF to the user and &8G0-&DFF 
to software houses, reserving &E00-&FFF for 
their own use. The only files which cannot be 
allocated a file type are those containing pure 
machine code which must be loaded at an 
address other than &800Q. This is because the 
part of the disc catalogue entry normally used 
for storing the file type is needed to store the 
load address of the machine code. 


FFF Plain ASCII Text 

FFE Command (or Exec) file 

FFD Data 

FFC Transient Utility 

FFB Tokenlsed Basic Program 

FFA Relocatable Module 

FF9 Sprite or Saved Screen 

FFS Absolute Code (to run at &80Q0) 

FF7 BBC Font 

FFS Fancy Font 

FEC WIMP Template files 

FEB Obey Files 


Table 1. Commonly used file types 


If you only use the Archimedes to run 
proprietary software, then you will probably not 
come into direct contact with fife types. 8ut they 
are at work nonetheless. It is the file type of a 
file which tells the Desktop which icon to 
display when representing it - and this is of 
much greater importance with RISC OS n where 
the Desktop becomes central to the operation 
of the whole machine. The file type is also used 
to determine what will happen when you *RUN 
or *LOAD a given file. If fife types are correctly 
set, then when you attempt to execute (i.e. 
*RUN) a data file, the corresponding application 
program will be loaded and run, and the data 
file will then be loaded into it. 


Additionally, file types can be used when 
writing your own applications. You can assign 
file types in the range 0 to &7FF, and then set 
up the machine to respond to these files in any 
way that you wish. Moreover, you can put a 
simple file type test into a program to ensure 
that it does not load in the wrong kind of file 
when loading user-selected data files, 

SETTING FILE TYPES 

Proprietary applications on the Arc 
(including Basic itself) automatically assign 
appropriate file types when files are saved. For 
example, when you save a Basic program, it 
will always be given the type &FFB. In some 
circumstances it is necessary for the 
programmer to set file types himself. For 
example, when writing an RMA module it must 
be specifically designated as type &FFA. And if 
you try to *RMLoad a file into the RMA which is 
not of this type, you will get the message: 

This is not a relocatable module 

There are two principal ways to set the type 
of a file. The simplest is to use the command: 

*SetType <filename> xxx 
where <filename> is the name of any file, and 
may include a pathname, and xxx is the file 
type. For example: 

*SetType $ .WORD PRO C, My Data 6FF 
This will set the file in directory S.WORDPROC 
named MyData to type &6FF. 

Alternatively, you can save a file and type it 
at the same time using the following OS call: 

SYS "OS_Flie",10,<filename>,<fiietype>,, 

< st a rt addr >,<endadd r> 

where <filename> is the name under which the 
file is to be saved, <filetype> is its type, and 
<startaddf> and <endaddr> are the start and 
end addresses of the block In RAM where the 
data resides. For example: 

SYS"GS_File", 10, "MyData 1 ', &6FF,, SAQOQ, 

FFF 

This will save the contents of RAM between 
&AGO0 and &AFFF under the file name MyData, 
and assign a file type of &6FF to it. 

READING FILE TYPES 

Unfortunately there is no easy way of 
reading tile types. You must use a SYS call 
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MAKING USE OF FILE TYPES 


from Basic (or the SWI equivalent from 
machine code). To make this easier, I have 
parcelled up the call into a Basic function called 
FNreadtype. The accompanying program 
makes use of this, requesting a filename of the 
user, and displaying the corresponding file 
type. 

The function is very easily incorporated into 
other programs. It is called with the file name 
as a single parameter, and returns its file type 
as a number between 0 and 4095. Additionally, 
it sets the variable filelen to the length of the 
target file. As a further example of its use, the 
following line will check whether the file 
MyData is of type &6FF: 

IF FNreadtype{"MyData")=£ 6FF THEN PRINT 
"ok* 


determine that double-clicking on a given 
application data fie on the RISC OS desktop 
will start the application itself - since double¬ 
clicking a file icon has the effect of *RUNning ft. 

It is also possible to set Load Types in a 
similar way. The following sequence will cause 
any *Load action on data files of type &6FF to 
run the application MyApp* and load them into 
it. 

*Set Alias$@LoadType_6FF MyApp %*Q 

The user may set load and run types for any file 
type that he wishes. These may even override 
those set up when the Archimedes initialises. 
The best place to perform such settings is in a 
boot file in the root directory of a disc, or in 
RJSG OS [Boot and !Run Obey files in an 
application directory. 


SETTING LOAD AND RUN ACTIONS 

On both the Arthur operating system and on 
RISC OS, the user may determine exactly what 
happens when a given file is *RUN or 
‘LOADed. This is controlled by the Aiias$ 
system variables. For example, if you enter the 
following: 

*Set A1ia 5$GRunType_6FF MyApp %*0 
This tells the filing system that whenever it 
receives the instruction: 

*RUN MyFile 
or *MyFile 

for a file of type &6FF, it must substitute the 
following: 

*MyApp MyFile 

In other words it will try to run the application 
itself, and load in the data file MyFiEe, The %*0 
means that al! parameters given with the 
original call, including the file name itself* will 
be passed across to the application program. It 
is by such means that the programmer can 


For further details on file types, the reader is 
referred to the Programmer's Reference 
Manual (pan 1), 


10 REM >WotType 

20 REM File Type Reader 

40 : 

50 PRINT* "File Type Reader 
60 *CAT 

70 REPEAT 

00 INPUT'"Filename",file $ 

90 type=FNreadtype(fileS) 

100 PRINT "File type- ,T ; 

110 IF type>0 THEN PRINT-type ELSE P 
RINT HI Machine Code" 

120 UNTIL FALSE 
130 : 


140 DEFFNreadtype {rtameS) 

150 £¥S 1, OS_File", 5, name$ TO, , loadaddr 
,* filelen 

160 IF (loadaddr»> 20 J -&FFF THEN:=£FFF 
AND Ioadaddr »>8 ELSE :“-1 


E3 


Points Arising....Point$ Arising....Points Arising....Points Arising.... 


ADFS FILE-FIND UPDATE by Lee Calcraft 


The short ADFS File-Find utility in Volume 1 
Issue 9 fails to work properly with certain 
nested directory structures. This is remedied by 
making the four arrays dir(}, dir${), file() and 
fi!e$0 LOCAL to the recursive procedure 
PROCsearch. To do this* alter line 190 to read: 

LOCAL n, dir () # dir${), file £), file$ 0 
and move lines 100 and 110 to 194 and 196. 


We are grateful to David Pringle for pointing 
out that, although the program will work on 
Econet, it will only read the first 32 items in any 
directory, because of the different way in which 
OSJ3BPB works on the network. The File-Find 
command in last month's Toolbox does not 
suffer from this limitation because it uses the 
call in a different way. ™ 


43 


RISC User March 1989 









REVIEWS 


RiscFORTH 


Reviewed by David Spencer 


Silicon Vision’s RiscFORTH is the first and so 
far only implementation of Forth for the 
Archimedes. This review will concentrate not only 
on RiscFORTH, but also on Forth itself for those 
who may be unfamiliar with this language. 

FIRST, SECOND, THIRD ... 

Forth is quite an interesting programming 
language, not least because of its total non- 
similarity to most other languages, except 
perhaps Prolog. Forth was designed by one 
Charles Moore in the early seventies, and got its 
name from the fact that Moore saw it as the first 
fourth-generation language. However, the IBM 
mainframe if was developed on allowed only five 
letter filenames, and therefore the V was missed 
out. 

As mentioned above, Forth is unlike any other 
modem high-level language, and indeed is also 
unlike any assembler language. In fact 
implementations of Forth cannot even by classed 
as either interpreters or compilers (See page 17 
of RISC User Vol.2 No.2 for the difference 
between these). It is instead a type of language 
known as a Threaded Interpretive Language 
(TIL). A TIL consists of a set of Words linked 
together in a linked list (hence the term threaded). 
Each Word consists of a header that contains the 
name of that Word and a link to the next Word, 
and a body which contains the machine code 
instructions to define the task performed by that 
particular Word. A simple Word, such as one to 
add two numbers together, would normally just 
contain the code to perform the operation directly, 
whereas a more complex Word, such as one to 
print out a numeric value, might in turn call other 
Words to perform the task. 

The concept of a program doesn't exist as 
such in a TIL. Instead, a complex task is 
performed by defining a new Word which makes 
calls to existing Words in order to perform that 
task. The process of creating a new Word is 
called 'compiling', and usually consists of creating 
a new entry in the linked list of Words, and 
building up the machine code instructions to call 
the Words that make up the new Word. Once a 
new Word is created it can be treated in the same 


way as existing Words, and can therefore be used 
in further definitions of other, more complex, Words. 

Forth also differs from other languages 
because arithmetic expressions are represented 
using a form called Postfix Notation, or more 
commonly, Reverse Polish Notation, invented by 
the Polish mathematician Lukasiewicz. If you 
consider the operation of addition in a normal 
language, the two operands appear on either side 
of the plus sign, for example: 

a = 12 + 23 

However, with Reverse Polish, all operands are 
stored on a stack. When an operation is 
performed the appropriate number of values are 
pulled from the stack, and the result is returned to 
the stack. In this form, our addition operation 
would look like: 

12 23 + 

This starts off by pushing first the value 12, and 
then the 23, onto the stack. The add operator 
then removes these two values from the stack, 
performs the addition and puts the result back on 
the stack. Assuming that the stack was empty at 
the start, then it will contain the single value of 35 
when the above operation has been performed. 
This value could then be pulled off and stored in a 
variable if desired. This method is extremely 
efficient to execute. 

STANDARDS 

The problem with a language such as Forth 
that can be so easily modified and extended, is 
that every user has a different version of the 
language. To overcome problems caused by this, 
attempts have been made to standardise the 
Forth language. Unfortunately, there are two 
differing standards. The official Forth standard, is 
called Forth-83. The opposing standard is Fig- 
Forth, named after the Forth interest Group, The 
tatter has lost popularity in recent years. 

I shall now concentrate on RiscForth itself. 
This is an implementation of Forth-83, with a 
number of system dependent extensions to take 
full advantage of the Archimedes' features. The 
software is supplied on a single BOOK disc, along 
with the manual, in a white plastic ’video case'. 
The system is started simply by booting the disc. 
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RE 


REVIEWS 


RiscFORTH 


EDITORS AND SCREENS 

As programs don’t exist in Forth, neither can 
the concept of saving a program. Instead, Word 
definitions can be stored as plain text in the so- 
called Screens file. This is simply a file containing 
a variable number of IK chunks of text, arranged 
as 16 lines of 64 characters. RiscFORTH 
includes a screen editor (written in Forth) to 
manipulate the screens files. Once saved, 
selected screens can be loaded and compiled. 
Word definitions can also be saved as normal 
text files. 

ASSEMBLER 

RiscFORTH also includes an ARM 
assembler, which in addition to normal 
instructions also supports the floating point op¬ 
codes. The assembler adheres to the doctrine of 
Reverse Polish, and hence its syntax will seem a 
bit strange. 

STAND-ALONE CODE 

The only way to produce stand-alone code 
from Forth is to save an entire copy of the 
language. This would normally result in a breach 
of copyright, however, Silicon Vision have 
provided a way around this problem. By using a 
special Forth Word it is possible to prevent the 
user from accessing directly any of the standard 
Words of the language. Provided this is done, 
you are free to distribute a 'copy' of the language, 

MULTI-TASKING 

RiscFORTH provides a form of multi tasking. 
This is a co-operative system, similar In some 
ways to that offered by RISC OS, although 
RiscFORTH doesn't restrict you to a WIMP 
environment. Instead, multi-tasking is achieved 
by defining a set of Words, each being an infinite 
loop, and each containing a special Word that 
switches between tasks. Each Word is then 
executed in turn in a Round-Robin type of 
arrangement. The multi-tasking system is 
particularly effective for the execution of multiple 
real-time applications. 

RiscFORTH contains a demonstration of 
multi-tasking in which a Mandelbrot fractal is 
drawn on the screen, while other Words can be 
executed simultaneously in a text window at the 
bottom of the screen. 
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DOCUMENTATION 

Forth is not an easy language to Seam, 
especially if it is your first programming language. 
Therefore, you might need to resort to a tutorial 
guide on Forth at an early stage. Flowever, don't 
expect to find such a book supplied with 
RiscFORTH. Instead, the 163 page A5 format 
manual is very much a reference guide. 

The main section, consisting of about half the 
manual, Is a glossary of alE the Words defined in 
the language as standard. The descriptions of 
each Word are fairly brief, and ! have discovered 
by delving into the code itself that there are some 
Words which are not documented at all, although 
these are mostly low-level system Words, One 
very useful feature of the manual is that the ASCII 
character set is printed in order at the foot of each 
page in this section. Many Forth words start with 
non-aiphabetFca! characters, and this guide 
makes It very easy to locate them in the list. 

Other sections cover the extensions in 
RiscFORTH, such as multi-tasking, the screen 
editor, the assembler and support for graphics. 
There are also sections on system dependent 
features and details of how particular Words are 
Implemented. On the whole, the manual served 
well as a reference guide, and it even lists some 
suggested titles for beginners to read. My only 
quibble is the binding. This is of the plastic comb 
form, with the comb being several sizes too small 
for the number of pages. It gets annoying after a 
while picking up pages from the floor. 

CONCLUSION 

RiscFORTH provides a good implementation 
of the Forth-83 standard, and is written in such a 
way as to make full use of the Archimedes' 
speed. Being the first version of Forth available 
makes it very hard to rate the standard of the 
package, although I could not find fault with it. 
The price of £99.95 inc, VAT is comparable with 
that of other Archimedes languages. 


Product 

RiscFORTH 

Supplier 

Silicon Vision Ltd,, 

Signal House, 

Lyon Road, Harrow 

Middlesex hai 2AG. 


Tel, 01-422 2274 or 


01-801 2173 

Price 

£93,95 Inc. VAT 
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SILICON VISION 

SOFTWARE FOR THE ARCHIMEDES & BBC 



SolidCAD 


t hr- ultimate 30 Draughting System for Arupj tee jurat design. in tenor design. Engineering 
Design and ledthmcj COT Allows drawing mplan. front £ side elevations and also directly 
■ i JO mew inc.fudteJi powerful tbom & pan options lor precision draughting and surface 
dntmition lot creating soiJ d colour ob|ec is Also incJudes Sweep. Extrude & Macro 
Li i 11 < r rf i for dusig n rug very c Qtnpiei abide E$ easily Deigns created with SotidCA D are 
i ompdPhtu tviih ttreRerrJfjuieGrdpfwnstanguiigefnrhrgft speed flicker-free animat;on 
Ffir i.indcim An t^medes tfersron also performs smooth shading for realism 
Sm dCADiAt l i users cart upgrade tu the Realtime Solids Modeller f Arc} for £40. 00 

£49.95 (ARC & BBC) New 


REALTIME SOLIDS MODELLER 

Lh i ■ pa c * a ge i m■ Judes both the soptm [ tented design environment of SolidCAD arid the 
high speed Animation capability ot a Realtime Graphics Language fRGU module 
i tevetoped ti i pure ARM Wise code tor supercharged performance The package is ideal for 
A> • r.jn (luji design fnfer-or design, Engineering design A leaching CDT. TheRGL 
■i m Kiwi- fjofit' used to create standalone Ihcker-tree animation of designs from your own 
ifugrjtms Smooth shading r s afsoperformed for realistic images Through Out rn-house 
r </m*i ri Kf ■ m IP fievgn and High ipeed techniques. no of he; package can riuaiihe design 
pnv,'j unmtmi & animation speed of the Realtime Solid* Modeller 

£89.95 (ARC) New 


REAL TfME GRAPHICS LANGUAGE 

r h*> rf e* i r i. op f 3 h i any u age ram p rovtde s a complete 3D Sands Wireframe 

i mi dim ■ ■ -■ with V Mar commands and 3D Editors to; designing ohfectu to animate 

tx.-in ijjf uinm programs Inuiudesa^S.dGWpfjefs sec line generator for fast 3D drawing 
r ,ite\ .IPRotom Sf.nJe Orfm Perspective and Turttegrephics Also compatible with 
dt ■ 11 s r: r**A fm.r w i th SuiidC AtJ r ti BC) 

£49.95 (BBC) 


SUPER-DUMP 

. r -‘uWnafp rnmtfrf rimi ■ which takes advantage of the highest resolution capability ot 
t n i ri ft, ■ omi la 1 idle pui\ ten, fo provide 192Q T 024 resotutio n. Images c ana iso be 

... >'M? pi^rtfn-K-danrf previewed before printing fully compatible with SolidCAD, 

Hi>alt i n i|, lj r at >t I n i i »gu age tidte A r ray de s fgn s y s Iem £ 3£> CA£) A nirtTatron system 
i' ■. 1 . > w 1 1 tj.' jp.fi i c i imig i a u is or other C A o pac k ages can be ma de c ompa tibie with Super 
; Jump: h t - rr.M Adupu-fKjJ a tew simple commands An pi ample program rs included m the 
f Mi frage 

£)5.95 (BBC). £24.95 (ARC) New 


Presentation Manager 

*r>i Km t . , h ■ ‘p +ii r '..rdi r.ir^. pnurnnrrpprit fo create edit and ptay hach eom-pufer 
: ■ ■ r ■ ►. ■> j i r i ■ . ifa; .. r. .r ir., fun-, and demonstrations Alsu handles graph plotting lor 
r * -.< .v .i-tij i. whnhcari tie incorporated wdhm'the 

£34.95 (BBC) t £49.95 (ARC) New 


SILICON VISION LTD , SIGNAL HOUSB, LYON ROAD f HARROW 
MIDDLESEX HA1 2AG. TEL 01-422 2274 or 01-8612173 
FAX. 01-4275169. TELEX: 918266 SIGNAL G. 

E3 (AccessIMestercardlEurocard accepted) 

Aft prices include VAT and Carriage (Overseas orders add £4). 


ARC-PCB 



The ufejitrafe PC 8 design system 
developed spec rf ic a tiy tor the A nc h rmede* 
ivrlh a specification that can not bo 
matched fnefudes Automatic routing. 

Rets nesMng. B layers. Surface mount 
capability, 0.001 resolution. 32 -32 
maximum board size, On JmeRefp Find 
Zoom Pan Redraw TextA SrJfcscreert 
facility. Variable Line Pad Text Grid sr/e:^ 
Part Libraries. Block Move Copy Router 
Mr;ronf;ase option^, and up to 300.000 

comport n ts for hardcopy. the sys tem 
supports a large number of platters and 
oidinaiy Epsoncompatihtepunters at very 
high re&otu Ubns (T 920 102*) of 240 dots 
inch for near laser quality output An entry 
Jewel ARC PC B system fwrmoui auto 

rotrtmgrfs avatiabie for r^S.95 ^Auto- 
routing upgrade CfOO} Enguueaboutou; 
turnkey PCB desrgn systems compJefe 
wjth Cotoyr Archrmedes and or plotters 
with puces horn VI220 to €3909 fine vA 7 1 


£195.00 (ARC) New 


RiscBASIC 

Supercharge you r Archirruipes Basrc 
programs by compdoig fhorrr 
aufomafn.dJJy jnto pure ARM Pise r tfdt 
htfiiO ihe RiscBASIC compiler features 
mcfudofloJocfllabJe modules Cross 
referent e of n if res, tunc t rm rv jnu 

procedures. Floating pftul t a rid In tegtrt 
support. Stand atone rode generator 
Qpfrrms rng compiler £ Fid/ runtime emu 
handler 


£99.95 (ARC) New 


RiscFORTH 

A new 32-bit Jflipfemtfrttafron ot the 
FORTH B3 standard designed to tak t tu ll 
advantage of the ARM aichlteciure 
featu/es rnefude Mufti (asfnrig 
Optimising comptiei built m ARM 
assembler Hrrth floating porni mnemtirnus 
Purft rrrfull screen fdjfo; Ftie system 
roterface, Oi tra t Is suppu r 1 f tciatmg p, r .<-i 
& integer maths WIMP support Smgf. 
s tap debugger 5 frado* s c; ee n for 
documentation Brr>. * manipulation 
Oir.ttonary i Vocabulary display Ca‘< 
tindmg atm a %tendaiAtrn* rotU qi ^ .t' • ■ 


£99.95 (ARC) New 
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We welcome your letters for publication in our 
Postbag page on all matters related to RISC User and 
the Archimedes. 

1ST WORD PLUS 

Fellow members may be interested in my first impressions 
of 1st Word Plus. To start with it is incredibly fast when 
compared with Arcwriter. This latter was definitely 
tiresome. By half way down the third page I was having to 
sit back and wait for each character to appear. The 
longest document I have so far typed in 1st Word Plus 
has ten pages, and even at the end it was more than 
keeping up. 

The next point is that every command works* unlike 
Arcwriter where underline, for example, has always been 
capricious. One slight moan is the prissy way in which 1st 
Word Plus insists that every document must be saved 
before it can be printed, but this is only minor. 

I have not yet investigated all the facilities, such as 
mailmerge, because I have no need for that, but on the 
whole I can really recommend this program. 

LE.Weaver 

Arcwriter may not be the strongest competition for 1st 
Word Plus, but we welcome Mr Weaver's comments. We 
hope to give greeter coverage in future issues of RISC 
User to commercieily available applications software 
(see article on Logistix in this issue), end would welcome 
your comments on choice of word processors, 
spreadsheets, databases and the like for the 
Archimedes. 

FLOATING POINT ARITHMETIC 

While ARM Basic is fast by any standards, there comes a 
time in mathematical problems where more speed is really 
needed, and I would normally look to assembler to get 
over the hard bits. Imagine my consternation to learn that 
the extremely available built-in assembler in Basic V wont 
touch real numbers. 

I was astonished to see that a Mandelbrot program in 
another magazine employed a binary procedure to allow 
the use of assembler. Why not use the Floating Point 
Emulator (FPE) I thought? The explanation came via a 
friend in the form of a Mandelbrot program which links the 
FPE with assembler. A nice piece of work yet it only runs 
twice as fast as my Basic only version. 

It seems that the FPE is an old crock put there to keep the 
seat warm for a co-processor yet to be decided about. 


What mathematician would enjoy running his favourite 
compiled language on an Archimedes at a mere speed 
gain of 2:1 over Basic? Would it not be possible to dig out 
Tie floating point routines which Basic V uses to handle 
floating point numbers and graft these onto the Basic ARM 
assembler? Pie in the sky? Well Apple users did it for the 
6602, despite total lack of support from Apple itself, and it 
results in a speed improvement for assembler of five to six 
times the equivalent Basic program. 

Arch Busby 

As Mr Busby himself says, the floating point emulator is 
written to emulate the planned hardware co-processor. 
This makes the FPE a general purpose maths package 
conforming to the IEEE standards for floating point 
representation. The floating point routines in Basic on the 
other hand are written solely for one purpose , They are 
written to operate at a lower precision than the FPE , and 
without all the stringent range checking etc . required of 
the FPE, Therefore, it is logical that this wifi prove to be 
faster than the emulator, although the real hardware co¬ 
processor wilt be many times faster than either. Mr Busby 
is a little unfair in his speed comparisons. Compiled 
languages and assembler code are generally several 
tens of times faster than the Basic equivalent. As for 
extracting the routines from Basic, this should not 
prove too hard, and perhaps somebody might like to 
try it 

MORE UTILITIES 

I must qualify as one of the first buyers of the Archimedes 
{around July/August 1987). I survived a period of no 
software and inadequate information only because I had 
my faithful model B. RISC User has, to a large extent, 
changed that, as it has been very useful in taking owners 
trough a very difficult first year. 

My one wish is that you will devote more attention to 
general purpose utilities for users t rather than 
programmers, fn a recent issue, the Disc Menu and 
Toolbox (disc editor) are the only stand-alone utilities for 
the non-programmer. However, if someone asks what I do 
with the Arc, I don't like to tell them that I use it to edit 
discs. 

You have helped us to understand the machine. Now help 
us to use it 

O.B.GIwa 


All reader comment is useful in determining the content 
of future issues, and this is one request we have already 
taken note of in our future planning, JjJJJ 
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Another collection of Archimedes hints and tips rounded up by David Spencer. 


LINE IT UP 

Matthew White 

Because the ARM is a 32-bit processor and RAM is 
addressed bytewise, it is often necessary to align an 
address to a word boundary when using data blocks. 
From within the assembler, the ALIGN directive can be 
used, but within Basic the easiest way to align an 
address addr to the next word boundary is to use: 
addr-addr+3 AND NOT 3 

MORE ALIGNMENT 
David Spencer 

A cautionary word of warning for assembly language 
programmers. Basic's assembler will automatically ensure 
that all instructions are word aligned, so for example; 

BL grabbyte 
EQUB 123 
LDMFD R13!,(PC} 

causes three zeros to be inserted after the value 123 to 
align the next instruction. However, if the LDM instruction 
had a label associated with it, then this label must appear 
on the same program line as the instruction. If the label is 
on a line of its own preceding the instruction then it will be 
given the value of the program counter before alignment. 
This causes havoc when the machine code is run, and is 
very hard to spot because it generates no assembly-time 
errors and is not at all obvious at a first glance. The safest 
solution is to always put an ALIGN directive after byte and 
half-word values. 

LIST OPTIONS 
Glynn Clements 

The Basic command LISTO can be used to provide a 
number of different formats for program listings. The 
command is followed by a number which specifies the 
format, the default setting being zero, The number 
representing the desired format is chosen by adding 
together the appropriate values from the list below: 

1 Print space after line number 

2 Indent structures (REPEAT etc.) 

4 Split m u I ti-statement 1 ines 

8 Don't list line numbers 

(Gives error if any line numbers 
referenced in program) 

16 List Basic keyword s in low e r case 
A value of 16 is useful for separating keywords and 
variable names if you have used upper-case for the latter, 
while a value of 14 (indent, split and no line numbers) 


gives a listing which resembles a Pascal program more 
than Basic, 

RISC OS ASSEMBLER LIMITS 
Andrew Johnson 

The Basic assembler in RISC OS has been extended to 
check against the code running over the end of the 
allocated space. By adding 8 to the OPT setting, the 
assembler will give an error if the value of P% exceeds 
Siat of L%. A statement such as: 

DIM code% 1000, L% -1 

will set L% to the address of the end of the area DIMed for 
code. Therefore, by enabling the checking you can ensure 
that the code doesn't run over the end of the allocated 
area. 

CLARIFYING COLOURS 
Robert Long 

Anybody who has tried to manipulate screen memory 
directly in a 266 colour mode may have discovered that 
the layout of bits within a pixel is not documented 
anywhere. The actual allocation for each bit (with the 


default palette settings] is; 

0 

Tint low 

1 

Tint high 

2 

Red low 

3 

Blue low 

4 

Red high 

5 

Green low 

6 

Green high 

7 

Blue high 


The two tint bits correspond to the value given to TINT 
divided by 64, See the descriptions of VDU17 and VDU23 
in the Programmer's Reference Manual for more details of 
the 256 colour numbers. 

TIME ON A KEY 
Graeme Davidson 

The commands: 

*SETMACRG Key$l <5ys$Date> 

*$ETMACRG Key$2 <Sys$Time> 
will set up functions keys one and two to produce the 
current date and time respectively. These could be used 
to insert the current values into a REM statement to 
identify different versions of a program under 
development, or they could be used to insert the current 
date into a word processor document. rm 
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DIARY for Archimedes 


ArcTFS - THE RESEARCH & AUTHOR'S DATABASE 


* Indexes, cross-references and files typed or imported A SGI text items up to 7700 characters in length. 

* Keeps searchable alphasorted files of explainers for all indexing 
and source codes. 

* Creates additional referencing fields to suit the subject 

* Creates text files up to 650K in length on a 800K disc - 
the equivalent of 80,000-100,000 words. 

* Searches text items directly or any referencing field. 

* Formats any subset and saves it as a file which will be read as a 
default - formatted native file, answerable to all reformatting 
commands, by AicWriter or 1st Word Plus. 

* Translates Word wise or View files in ASCI form into AicWriter 
or 1st Word Plus format, and gives database indexing and control 
of these files in the meantime. 

”There is no doubt about the value of ArcTFS to the writer or the researcher. It's easy to use , and allows 

sophisticated searching and sorting of text. Anyone who needs to manage large amounts of this sort of 

information should find ArcTFS invaluable M Dave Futcher Acorn User November 1988. 

ArcTFS (Text Filing System) - £29.95 

(Cheque or PO only) to: 

TEXCELLENCE, 2 Greenhill Road, Coleraine, N.Ireland BT513JE 

(For further details send SAE) 


LrcTP! 




Sec a full jeer at > glance. 

A single screen shows part of the entry for 
every day of the year. See the free days or spot 
that elusive entry at a glance. 

Instant viewing of the full entry for any day. 

Skim the mouse over the year to scan the full 
entries for any day, ft Just 'click' on a day to 
make an entry. 

Print all of a month with just one command. 

Select the month, or months, to be printed. 
Then choose from either a full page, weekly 
formatted print-out. or a aulek single line per 
day. showing only those days which have an 
entry. 

"Arthur" version £9.95 

Unci, vat ft U.K. pftp) 

MULTI-TASKING ”RISC-08" DESKTOP 

version £14.95 

Ready In April', will allow user selection of 
larger diary sizes ft string search facility. 

—• SPECIAL OFFER for this month •••• 
"Arthur" version Including upgrade, only £10.95 


Competent Archimedes 
programmer for occasional 
software projects. 

The work will be interesting 
and rewarding. 

The successful applicant will be 
keen, self-motivated, 
and preferably live in the 
Southwest. 


Please write giving full details to 


Box no. RU 101 
RISC User 

Dolphin Place, Holywell Hill, 
St Albans, Herts AL1 1EX 


Cheque or P.O. to Official Orders also welcome. 

QUERCUS COMPUTER SYSTEMS 
Courtyard Hows, North Ottsrlngton, 
Northallerton, N.Yorks. DL7 »EP (td. 0609 70643) 














































Dabhand User News 


Archimedes Basic Compiler Version 2 • Archimedes Operating System Guide 
Special Offers on Archimedes PC Emulator and ANSI C 


ABC Version 2 

Don't live on promises, buy the only 
true BASIC V Compiler currently avail¬ 
able, and now in its second release! 
But don't take our word here’s what the 
reviewers said: 

"...Excellent Dabs Press product. Buy 
it!" RISC User Dec.88 

"ABC is a vital part of any programmer's 
toolbox, it puts compilers on other 
systems to shame. Unquestionably one 
of the most impressive pieces of soft¬ 
ware I have yet seen running on the 
Archimedes.''MB Dec 1988 

".../ can tell you now, I am very im¬ 
pressed. This is a superb package." 
Archive Dec 1988 

The above quotes were referring to 
Version 1 of ABC - ABC Version 2 is 
even better! Version 2 allows use of 
double and extended precision float¬ 
ing point, multiple exits from proce¬ 
dures and functions, RETURN parame¬ 
ter passing, new compiler directives 
and very much more. 

As all reviewers have found, ABC 
makes writing machine code programs 
and relocatable modules easy. Pro¬ 
grams can be written using the full 
range of BASIC V’s error messages 
and report's, and once fully working, 
run through ABC which transforms 
them into machine code, ready for 
immediate action. 

Demo Disc: We have produced ademo 
disc of ABC which still supports over 
100 commands. It costs just £2 and 
this is refundable on any subse- 
quentpurchase. A full specification 
sheet is also available on request. 


Free upgrades! 


£ 99.95 


Archimedes OS Book 

Hot off the presses, this latest Dabhand 
Guide is essential reading for every 
user of the Operating System includ¬ 
ing Arthur and RISC OS. 

Its 320 pages are packed with vital in¬ 
formation and covers topics such as 
VIDC, MEMC, IOC, Sound. SWIs, 
Vectors, Filing System and very much 
more. Price is just £14.95 or £21.95 
with programs disc and manual. 

Archimedes Assembly 
Language 

386 pages devoted to programming 
the Archimedes in machine code. At 
£14.95 it is the only book which deals 
specifically with assembler on the 
Archimedes. Book and programs disc 
ordered together - £21.95. 

Archimedes Games! 

Arcendium: Board Game Fun 

Backgammon, Draughts, Reversi and 
Quadline - four games for the price of 
one! Sure to get the whole family using 
the Archimedes. Juat £14.95. 

Alerlon: Arch Imedes Arcade Action! 
The highly acclaimed all-action shoot- 
em-up for the Archimedes. 256 colour 
mode graphics, with digitised speech. 
Impossible to finish! Superb fun! 
"...the game pi ay makes this game a 
winner...a first rate game..." A&B 
Computing. Price £14.95. 

C: A Dabhand Guide 

PCW said: "I only wish this book had 
been available when I was learning C. * 
It you want to learn ANSI C then this 
512 page volume is the way to do it. At 
£14.95 it represents quite incredible 
value. Book and programs disc £21.95. 


Archimedes PC 
Emulator Shareware 

Five discs full of PC software tested 
with the emulator to ensure com¬ 
patibility. The collection includes 
software you would normally expect 
to pay a fortune for and includes a 
wordprocessor, spreadsheet, 
games, flowchart designer, printer 
utilities, and more. £34 gg 

SPECIAL OFFERS! 

PC Emulator and 
FREE Shareware 

Purchase the Archimedes PC 
Emulator from us and we'll give you 
our Shareware pack- detailed above 
and worth £34.95 - absolutely tree 
of charge. Price just £113.85 inc. 

ANSI C and FREE 
Dabhand Guide to C 

The best combination! Purchase 
Acomsofts ANSI C and well throw 
in our top-selling Dabhand Guide to 
C - 512 pages and worth £14.95. 
Price just £113.85 inc VAT & p&p. 

On the Lookout 

Dabs Press are always on the look¬ 
out for authors who feel that they 
have what it takes to write either 
software or Dabhand Guides. If you 
have a useful idea then we can 
make it reality. If you don't have the 
idea but do have what it takes then 
we still want to hear from you. Our 
experience is second to none - if 
you want to be tops get in touch. 

FREE on Request 
Bumper Catalogue! 


DABS 




5 Victoria Lana (RUM), Whitafield, Manchester M25 6 AL 
Tel: 061-766 8423 BT Gold: 72:MAG11596 Pres tel: 942876210 

Prices include VAT and PSP (UK/BFPO/CI). ACCESS/VISA accepted by post/phone/Mailbox/ 
in person. Cheques and POs to address above. Dabs Press products available from all good 
dealers. Add £2.50 (£12 air) if outside UK. Official orders welcome. 
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IMAGE WRAP AND SPIN A ulility to wrap 4 a flat image around the surface of a sphere. The demonstration 
program uses this to produce images trom different angles f giving the effect of a spinning bail. 

RISC USER TOOLBOX_ 

The complete Toolbox toe, from this issue a set of 
disc searching commands and a useful help feature. 

MAKING USE OF FILE TYPES 
A short program to demonstrate how file types can be 
read from within your own programs. 

SIMPLE SPRITE MANAGER 

A useful module that allows sprite definitions to be 
displayed before deletion, 

NEW FONT STYLES 

A module that provides 72 different styles of the 
standard screen font. 

ARCHIMEDES VISUALS 

A sixteen colour fader, and a spirograph which 
produces an infinite variety ol pa Items, 



BONUS ITEMS 


ARC UTILITY 

A new version of BEEBUG's public domain fife archiver 
and de-archiver which is lully RISC OS compalibfe. 
Documentation Es included on the disc 

RAY CHAMBER 

A demonstration of the ray (racing capabilities of the 
Archimedes. 

A RISC OS APPLICATION 
A sample application, designed to multi-task under 
RISC OS, which illustrates the use of application 
directories and the multi-tasking WIMP cal is. 

BALLONVANG 

An easy-to-play game thal is ideal for children. 
ARC SCAN DATA 

Index entries for this issue of RISC User and the latest 
BEEBUG [Vo 1.7 No.8} to be used with A rescan. 


RISC Us&r magazine discs are available to order, or by subscription. Full cfeiaEEs of prices etc. are given on the back cover of each Issue of RISC User. 
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BINDERS 

£3.90 + £i p&p 

BEEBUG Ltd 

Dolpln Place, Holywell Hill, St. Albans, Herts M 
ALl 1EX r 

Tel. (0727) 40303 
























RISC USER magazine 



RISC User Is available only on subscription at the rates shown below. Full subscribers to RISC User may also take out 
a reduced rate subscription to BEEBUG (the magazine for the BBC micro and Master series). 

SSfflSt RISC USER SUBSCRIPTION RATES RISC USER 

pounds sterling. We will & BEEBUG 

also accept payment by £14.50 1 year (10 issues) UK, BFPO, Ch.l £23.00 

Connect, Access and £20.00 Rest of Europe & Eire £33.00 

Visa, and official UK £25.00 Middle East £40.00 

orders are welcome. £27.00 Americas & Africa £44.00 

£29.00 Elsewhere £43.00 

BACK ISSUES 

We intend to maintain stocks of back issues New subscribers can therefore obtain earlier copies to provide a 
complete set from Vol. 11ssue 1. Back issues cost £1.20 each. You should also include postage as shown: 



Destination 

First Issue 

Each subsequent Issue 


UK, BFPO, Ch.ls 

60p 

30p 


Europe plus Eire 

£1 

50p 


Elsewhere 

£2 

£1 



MAGAZINE DISC 


The programs from each issue of RISC User are available on a monthly 3.5 9 disc. This will be available to order, or 
you may take out a subscription to ensure that the disc arrives at the same time as the magazine. The first issue (with 
six programs and animated graphics demo) is at the special low price of £3.75. The disc for each issue contains all the 
programs from the magazine, together with a number of additional items by way of demonstration, all at the standard 
rate of £4.75. 

Disc subscriptions include postage, but 

MAGAZINE DISC PRICES UK Ov«*.a. 1 "I f* 1 .*.*.!!!*! * 

angle issue dscs £475 £475 

Six months subscription cn ^ 

Twelve months subscription 


UK 

£ 4.75 
£25.50 
£50.00 


Overseas 

£ 4.75 
£30.00 
£56.00 


nonrns suoscnprion iou.uu too.uu M ^ subscnptK)ns and other 

correspondence should be 
addressed to: 

RISC User, Dolphin Place, Holywell Hill, St Albans, Herts AL1 1EX. 
Telephone: St Albans (0727) 40303 

(24hrs answerphone service for payment by Connect. Access or Visa card) 



















